@azure-tools/typespec-azure-resource-manager 0.70.0-dev.1 → 0.70.0-dev.10

package/lib/base-types/agent.tsp

@@ -183,36 +183,87 @@ model AgentPropertiesPlatform<AgentDefinitionType extends AgentDefinition> {
  * exchanged between a client and an agent.
  */
 model ConversationProperties {
-  /** Unique conversation identifier. Read-only (set by the service on creation). */
-  @visibility(Lifecycle.Read)
-  conversationId?: string;
-
   /** Timestamp of when the conversation was created. Read-only. */
   @visibility(Lifecycle.Read)
-  createdAt?: unixTimestamp32;
+  createdAt?: utcDateTime;
 }
 
 /**
- * A single input message provided to the model.
+ * The role of the author of a message item.
  */
-model InputMessage {
-  /** The role of the message author (for example, user, system, or developer). */
-  role: string;
+enum MessageRole {
+  /** A developer-authored instruction message. */
+  Developer,
+
+  /** A message authored by the end user. */
+  User,
 
-  /** The content of the input message. */
-  content: string;
+  /** A message generated by the assistant (agent). */
+  Assistant,
+
+  /** A message representing the output of a tool. */
+  Tool,
 }
 
-/** Mix-in for input type discriminator. */
-model InputTypeProperty {
-  /** The input type discriminator. */
-  type?: string = "message";
+/**
+ * The type of an item exchanged within a conversation or produced in a response.
+ */
+enum ItemType {
+  /** A message authored by a developer, user, assistant, or tool. */
+  Message,
+
+  /** A function (tool) call requested by the model. */
+  FunctionCall,
+
+  /** The output produced by a function (tool) call. */
+  FunctionCallOutput,
+
+  /** A compaction item summarizing earlier conversation history. */
+  Compaction,
 }
 
-/** Output from a conversation. */
-model ConversationOutput {
-  /** The output identifier. */
-  id: string;
+/**
+ * A single item exchanged within a conversation.
+ *
+ * The `type` discriminator selects the item variant. Only the fields relevant to
+ * that variant are populated, so all variant-specific fields are optional:
+ *   - `Message`: `role`, `content`
+ *   - `FunctionCall`: `callId`, `name`, `arguments`
+ *   - `FunctionCallOutput`: `callId`, `output`
+ *   - `Compaction`: `summary`
+ */
+model ConversationItem {
+  /** Unique identifier of the item. Read-only (assigned by the service). */
+  @visibility(Lifecycle.Read)
+  id?: string;
+
+  /** The item type discriminator. Determines which variant this item represents. */
+  type: ItemType;
+
+  /** The role of the message author. Applies to `Message` items. */
+  role?: MessageRole;
+
+  /** The text content of the message. Applies to `Message` items. */
+  content?: string;
+
+  /** Identifier correlating a function call with its output. Applies to `FunctionCall` and `FunctionCallOutput` items. */
+  callId?: string;
+
+  /** The name of the function (tool) to invoke. Applies to `FunctionCall` items. */
+  name?: string;
+
+  /** Named arguments passed to the function (tool), keyed by parameter name. Applies to `FunctionCall` items. */
+  arguments?: Record<unknown>;
+
+  /** The output produced by the function (tool) call. Applies to `FunctionCallOutput` items. */
+  output?: string;
+
+  /** Summary of the compacted conversation history. Applies to `Compaction` items. */
+  summary?: string;
+
+  /** The status of the item. Read-only. */
+  @visibility(Lifecycle.Read)
+  status?: ResponseStatus;
 }
 
 // ============================================================================
@@ -226,24 +277,24 @@ model ConversationOutput {
 union ResponseStatus {
   /** The response completed successfully. */
   @Azure.Core.lroSucceeded
-  Completed: "completed",
+  Completed: "Completed",
 
   /** The response failed. */
   @Azure.Core.lroFailed
-  Failed: "failed",
+  Failed: "Failed",
 
   /** The response was cancelled. */
   @Azure.Core.lroCanceled
-  Cancelled: "cancelled",
+  Cancelled: "Cancelled",
 
   /** The response is incomplete. */
-  Incomplete: "incomplete",
+  Incomplete: "Incomplete",
 
   /** The response is queued for execution. */
-  Queued: "queued",
+  Queued: "Queued",
 
   /** The response is in progress. */
-  InProgress: "in_progress",
+  InProgress: "InProgress",
 
   string,
 }
@@ -253,13 +304,9 @@ union ResponseStatus {
  * including its output, status, and usage.
  */
 model ResponseProperties {
-  /** Unique response identifier. Read-only (set by the service). */
-  @visibility(Lifecycle.Read)
-  responseId?: string;
-
   /** Timestamp of when the response was created. Read-only. */
   @visibility(Lifecycle.Read)
-  createdAt?: unixTimestamp32;
+  createdAt?: utcDateTime;
 
   /** Model ID used to generate the response. May be specified on request to override the agent default; read-only in GET. */
   `model`?: string;
@@ -269,39 +316,66 @@ model ResponseProperties {
   status?: ResponseStatus;
 
   /** Content input to the model. Required on create. */
-  input: InputMessage;
+  input: ConversationItem;
 }
 
 /**
  * An item produced in the response output, such as a message or tool call.
+ *
+ * The `type` discriminator selects the item variant. Only the fields relevant to
+ * that variant are populated, so all variant-specific fields are optional:
+ *   - `Message`: `role`, `content`
+ *   - `FunctionCall`: `callId`, `name`, `arguments`
+ *   - `FunctionCallOutput`: `callId`, `output`
+ *   - `Compaction`: `summary`
  */
-model ResponseOutputItem {
-  /** Unique identifier of the output item. */
+model ResponseItem {
+  /** Unique identifier of the output item. Read-only. */
   @visibility(Lifecycle.Read)
   id?: string;
 
-  /** The output item type (for example, message or tool call). */
+  /** The item type discriminator. Read-only. */
   @visibility(Lifecycle.Read)
-  type?: string;
+  type?: ItemType;
 
-  /** The role associated with the output item. */
+  /** The role of the message author. Applies to `Message` items. Read-only. */
   @visibility(Lifecycle.Read)
-  role?: string;
+  role?: MessageRole;
 
-  /** The status of the output item. */
+  /** The text content of the message. Applies to `Message` items. Read-only. */
   @visibility(Lifecycle.Read)
-  status?: ResponseStatus;
+  content?: string;
 
-  /** The content of the output item. */
+  /** Identifier correlating a function call with its output. Applies to `FunctionCall` and `FunctionCallOutput` items. Read-only. */
   @visibility(Lifecycle.Read)
-  content?: string;
+  callId?: string;
+
+  /** The name of the function (tool) invoked. Applies to `FunctionCall` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  name?: string;
+
+  /** Named arguments passed to the function (tool), keyed by parameter name. Applies to `FunctionCall` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  arguments?: Record<unknown>;
+
+  /** The output produced by the function (tool) call. Applies to `FunctionCallOutput` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  output?: string;
+
+  /** Summary of the compacted conversation history. Applies to `Compaction` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  summary?: string;
+
+  /** The status of the output item. Read-only. */
+  @visibility(Lifecycle.Read)
+  status?: ResponseStatus;
 }
 
 /** Mix-in for the output property. */
 model ResponseOutputProperty {
   /** Output items (messages, tool calls, etc.). Read-only. */
   @visibility(Lifecycle.Read)
-  output: ResponseOutputItem[];
+  output: ResponseItem[];
 }
 
 /** Mix-in for the previousResponseId property. */

package/lib/base-types/base-types.tsp

@@ -28,12 +28,18 @@ model BaseTypeInfo {
  * @example
  *
  * ```typespec
- * @azureBaseType(#{ baseType: "Agent", version: "2024-06-01" })
- * model MyAgentProperties {
- *   ...AgentProperties;
- *   ...AgentToolProperty;
+ * // Agent definition and properties using the Appliance deployment model
+ * model ContosoApplianceDefinition is AgentDefinitionAppliance<true, true>;
+ * model ContosoApplianceProperties is AgentPropertiesAppliance<ContosoApplianceDefinition> {
  *   ...DefaultProvisioningStateProperty;
  * }
+ *
+ * // The @azureBaseType decorator marks the resource as conforming to the Agent base type.
+ * // (The Agent template applies this automatically, but it can also be applied directly.)
+ * @azureBaseType(#{ baseType: "Agent", version: "2024-06-01" })
+ * model ContosoApplianceAgent is TrackedResource<ContosoApplianceProperties> {
+ *   ...ResourceNameParameter<ContosoApplianceAgent>;
+ * }
  * ```
  */
 extern dec azureBaseType(target: Model, baseType: valueof BaseTypeInfo);

package/lib/common-types/common-types.tsp

@@ -4,7 +4,7 @@ import "./types-ref.tsp";
 import "./managed-identity-ref.tsp";
 import "./managed-identity-with-delegation-ref.tsp";
 import "./private-links-ref.tsp";
-import "./customer-managed-keys-ref.tsp";
+import "./customer-managed-keys.tsp";
 import "./extended-location-ref.tsp";
 import "./internal.tsp";
 import "./commontypes.private.decorators.tsp";

package/lib/common-types/nsp-operations.tsp

@@ -92,7 +92,7 @@ interface NspConfigurationOperations<
   ResourceParameter extends {} = NspConfigurationNameParameter<NspConfigurationKeyName>
 > {
   /**
-   * @dev List the network security perimeter configurations to a resource
+   * List the network security perimeter configurations to a resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Resource Optional. The NspConfiguration resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -127,7 +127,7 @@ interface NspConfigurationOperations<
   >;
 
   /**
-   * @dev List the network security parameter configuration for a resource without pagination - this should only be used for legacy operations
+   * List the network security parameter configuration for a resource without pagination - this should only be used for legacy operations
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Resource Optional. The NspConfiguration resource being listed
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -162,7 +162,7 @@ interface NspConfigurationOperations<
   >;
 
   /**
-   * @dev GET a network security perimeter configuration for a particular resource
+   * GET a network security perimeter configuration for a particular resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Resource the NspConfiguration resource being read
    * @template BaseParameters Optional. Allows overriding the operation parameters
@@ -196,7 +196,7 @@ interface NspConfigurationOperations<
   >;
 
   /**
-   * @dev Perform an action on a network security perimeter configuration for a particular resource
+   * Perform an action on a network security perimeter configuration for a particular resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Request The request body type
    * @template Response The success response for the read operation
@@ -238,7 +238,7 @@ interface NspConfigurationOperations<
   ): Response | Error;
 
   /**
-   * @dev Perform an action on a network security perimeter configuration for a particular resource
+   * Perform an action on a network security perimeter configuration for a particular resource
    * @template ParentResource the parent resource of the NspConfiguration
    * @template Request The request body type
    * @template Response The success response for the read operation

package/lib/common-types/types.tsp

@@ -344,8 +344,7 @@ union createdByType {
   string,
 }
 
-/** @dev Resource Identity Type */
-@doc("")
+/** Resource Identity Type */
 union ResourceIdentityType {
   SystemAssigned: "SystemAssigned",
 }
@@ -369,7 +368,7 @@ model Identity {
   type?: ResourceIdentityType;
 }
 
-/** @dev Properties of a KeyVault */
+/** Properties of a KeyVault */
 model KeyVaultProperties {
   /** Key vault uri to access the encryption key. */
   keyIdentifier?: string;

package/lib/decorators.tsp

@@ -19,7 +19,6 @@ namespace Azure.ResourceManager;
  * ```
  *
  * @param providerNamespace Provider namespace
- * @param libraryNamespaces a library namespace containing types for this namespace
  *
  */
 extern dec armProviderNamespace(target: Namespace, providerNamespace?: valueof string);
@@ -32,7 +31,9 @@ extern dec armProviderNamespace(target: Namespace, providerNamespace?: valueof s
 extern dec useLibraryNamespace(target: Namespace, ...namespaces: Namespace[]);
 
 /**
- * `@armLibraryNamespace` designates a namespace as containign Azure Resource Manager Provider information.
+ * `@armLibraryNamespace` designates a namespace as containing Azure Resource Manager Provider information.
+ * This is used for library namespaces that define reusable ARM resource types that can be shared
+ * across multiple provider specifications.
  *
  * @example
  *
@@ -110,18 +111,25 @@ extern dec resourceGroupResource(target: Model);
 extern dec extensionResource(target: Model);
 
 /**
- * `@armResourceType` sets the value fo the decorated string
- * property to the type of the Azure Resource Manager resource.
- * @param resource The resource to get the type of
+ * `@armProviderNameValue` sets the provider namespace value on operations.
+ * It is used internally to inject the correct provider namespace path segment
+ * for resource operations in auto-generated routes.
  */
 extern dec armProviderNameValue(target: Operation);
 
 /**
- * Marks the operation as being a collection action
+ * Marks the operation as being a collection action that is not associated with a specific resource instance.
+ * Collection actions are operations that act on a resource collection rather than a single resource,
+ * such as `checkNameAvailability` or provider-level actions.
  */
 extern dec armResourceCollectionAction(target: Operation);
 
 /**
+ * Marks the operation as a custom action on a specific Azure Resource Manager resource type.
+ * This decorator associates a POST action operation with its resource,
+ * identifying the semantics of the operation as a resource action over a specific resource for documentation,
+ * resource validation, and use by downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -132,6 +140,10 @@ extern dec armResourceAction(
 );
 
 /**
+ * Marks the operation as a create or update (PUT) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a CreateOrReplace lifecycle operation over a particular resource,
+ * for use in documentation, resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -142,12 +154,20 @@ extern dec armResourceCreateOrUpdate(
 );
 
 /**
+ * Marks the operation as a read (GET) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a Read lifecycle operation over a particular resource,
+ * for use in documentation, resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
 extern dec armResourceRead(target: Operation, resourceModel: Model, resourceName?: valueof string);
 
 /**
+ * Marks the operation as an update (PATCH) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the operation as an Update lifecycle operation over the resource for use in documentation,
+ * resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -158,6 +178,10 @@ extern dec armResourceUpdate(
 );
 
 /**
+ * Marks the operation as a delete (DELETE) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the operation as a Delete lifecycle operation over the resource for us in documentation,
+ * resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -168,6 +192,10 @@ extern dec armResourceDelete(
 );
 
 /**
+ * Marks the operation as a list (GET collection) operation for a specific Azure Resource Manager resource type.
+ * This decorator identifies the semantics of the operation as a collection list operation over a resource type and a particular scope for documentation,
+ * resource validation, and downstream emitters.
+ *
  * @param resourceModel Resource model
  * @param resourceName Optional. The name of the resource. If not provided, the name of the resource model will be used.
  */
@@ -242,21 +270,22 @@ extern dec armCommonTypesVersion(
 
 /**
  * This decorator is used on Azure Resource Manager resources that are not based on
- * Azure.ResourceManager common types.
+ * Azure.ResourceManager common types. It marks a model as an ARM virtual resource,
+ * which is useful for defining the scope of resources used only as parents for child resources, or scopes for extension resources.
  *
- * @param propertiesType: The type of the resource properties.
  * @param provider Optional. The resource provider namespace for the virtual resource.
  */
 extern dec armVirtualResource(target: Model, provider?: valueof string);
 
 /**
- * This decorator sets the base type of the given resource.
+ * This decorator sets the base type of the given resource, indicating where in the
+ * Azure Resource Manager hierarchy the resource is located.
  *
- * @param baseTypeIt The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension"
+ * @param baseType The built-in parent of the resource, this can be "Tenant", "Subscription", "ResourceGroup", "Location", or "Extension"
  */
 extern dec resourceBaseType(
   target: Model,
-  baseTypeIt: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension"
+  baseType: "Tenant" | "Subscription" | "ResourceGroup" | "Location" | "Extension"
 );
 
 /**
@@ -274,3 +303,44 @@ extern dec resourceBaseType(
  * ```
  */
 extern dec identifiers(entity: ModelProperty | Array<unknown>, properties: valueof string[]);
+
+/**
+ * Options for defining a feature file and its associated output
+ */
+model ArmFeatureFileOptions {
+  /** The feature name */
+  featureName: string;
+
+  /** The associated file name for the features */
+  fileName: string;
+
+  /** The feature description in Swagger */
+  description: string;
+
+  /** The feature title in Swagger */
+  title?: string;
+
+  /** The feature terms of service in Swagger */
+  termsOfService?: string;
+}
+
+/**
+ * Decorator to define a set of feature files for splitting output
+ * @param target The service namespace
+ * @param features The enum that contains the features
+ */
+extern dec featureFiles(target: Namespace, features: Enum);
+
+/**
+ * Decorator to define options for a specific feature file
+ * @param target The enum member that represents the feature
+ * @param options The options for the feature file
+ */
+extern dec featureFileOptions(target: EnumMember, options: valueof ArmFeatureFileOptions);
+
+/**
+ * Decorator to associate a feature file with a model, interface, or namespace
+ * @param target The target to associate the feature file with
+ * @param featureName The feature to associate with the target
+ */
+extern dec featureFile(target: Model | Operation | Interface | Namespace, featureName: EnumMember);

package/lib/extension/operations.tsp

@@ -176,7 +176,7 @@ op CreateOrReplaceSync<
 >;
 
 /**
- * @dev A long-running resource CreateOrUpdate (PUT)
+ * A long-running resource CreateOrUpdate (PUT)
  * @template TargetResource the target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource the resource being created or replaced
  * @template LroHeaders Optional.  Allows overriding the lro headers returned on resource create
@@ -288,7 +288,7 @@ op CustomPatchSync<
 >;
 
 /**
- * @dev Delete a resource asynchronously
+ * Delete a resource asynchronously
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being deleted
  * @template Response The response type for the operation
@@ -314,7 +314,7 @@ op DeleteAsyncBase<
   | Error;
 
 /**
- * @dev Delete a resource asynchronously.
+ * Delete a resource asynchronously.
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being deleted
  * @template LroHeaders Optional. Allows overriding the headers in the Accepted response
@@ -351,7 +351,7 @@ op DeleteAsync<
 >;
 
 /**
- * @dev Delete a resource asynchronously
+ * Delete a resource asynchronously
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being deleted
  * @template LroHeaders Optional. Allows overriding the headers returned in the Accepted response
@@ -444,7 +444,7 @@ op ActionAsyncBase<
 ): Response | Error;
 
 /**
- * @dev A long-running resource action.
+ * A long-running resource action.
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being acted upon
  * @template Request The request model for the action
@@ -459,6 +459,7 @@ op ActionAsyncBase<
 @extensionResourceOperation(TargetResource, ExtensionResource, "action", OverrideResourceName)
 @returnsDoc("Azure operation completed successfully.")
 @enforceConstraint(ExtensionResource, Foundations.Resource)
+@doc("")
 op ActionAsync<
   TargetResource extends Foundations.SimpleResource,
   ExtensionResource extends Foundations.SimpleResource,
@@ -520,7 +521,7 @@ op ActionSync<
 ): Response | Error;
 
 /**
- * @dev A long-running resource action that returns no content.
+ * A long-running resource action that returns no content.
  * @template TargetResource The target resource, e.g. Extension.Subscription or Extension.ManagementGroup or Extension.ResourceGroup
  * @template ExtensionResource The resource being acted upon
  * @template Request The request model for the action
@@ -535,6 +536,7 @@ op ActionSync<
 @enforceConstraint(TargetResource, Foundations.Resource)
 @enforceConstraint(ExtensionResource, Foundations.Resource)
 @post
+@doc("")
 op ActionNoResponseContentAsync<
   TargetResource extends Foundations.SimpleResource,
   ExtensionResource extends Foundations.SimpleResource,

package/lib/foundations/arm.foundations.tsp

@@ -140,29 +140,37 @@ alias TenantParentScope<Resource extends Foundations.SimpleResource> = TenantSco
  * Parameter model for listing a resource at the tenant scope
  * @template Resource The type of the resource.
  */
-model TenantScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, TenantBaseParameters>;
+model TenantScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  TenantBaseParameters
+>;
 
 /**
  * Parameter model for listing a resource at the subscription scope
  * @template Resource The type of the resource.
  */
-model SubscriptionScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, SubscriptionBaseParameters>;
+model SubscriptionScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  SubscriptionBaseParameters
+>;
 
 /**
  * Parameter model for listing a resource at the location scope
  * @template Resource The type of the resource.
  */
-model LocationScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, LocationBaseParameters>;
+model LocationScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  LocationBaseParameters
+>;
 
 /**
  * Parameter model for listing an extension resource
  * @template Resource The type of the resource.
  */
-model ExtensionScope<Resource extends Foundations.SimpleResource>
-  is ResourceParentParameters<Resource, ExtensionBaseParameters>;
+model ExtensionScope<Resource extends Foundations.SimpleResource> is ResourceParentParameters<
+  Resource,
+  ExtensionBaseParameters
+>;
 
 /**
  * Parameter model for listing a resource at the resource group scope
@@ -240,22 +248,24 @@ op checkNameAvailability<
 ): Response | ErrorResponse;
 
 /**
- * @dev The base template for Azure Resource Manager GET and HEAD Operations.
+ * The base template for Azure Resource Manager GET and HEAD Operations.
  * @template Parameters The parameter object for the operation.
  * @template Response The response or union of responses for success.
  * @template ErrorResponse The error response.
  */
+@doc("")
 op ArmReadOperation<Parameters extends {}, Response extends {}, ErrorResponse extends {}>(
   ...Parameters,
 ): Response | ErrorResponse;
 
 /**
- * @dev The base template for Azure Resource Manager PUT Operations.
+ * The base template for Azure Resource Manager PUT Operations.
  * @template HttpParameters The parameter object for the operation.
  * @template BodyParameter The body parameter
  * @template Response The response or union of responses for success.
  * @template ErrorResponse The error response.
  */
+@doc("")
 op ArmCreateOperation<
   HttpParameters extends {},
   BodyParameter extends {},
@@ -266,12 +276,13 @@ op ArmCreateOperation<
   | ErrorResponse;
 
 /**
- * @dev The base template for Azure Resource Manager PATCH Operations.
+ * The base template for Azure Resource Manager PATCH Operations.
  * @template HttpParameters The parameter object for the operation.
  * @template BodyParameter The body parameter
  * @template Response The response or union of responses for success.
  * @template ErrorResponse The error response.
  */
+@doc("")
 op ArmUpdateOperation<
   HttpParameters extends {},
   BodyParameter extends {},