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

package/dist/src/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCxB,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CxB,CAAC"}

package/dist/src/state.js

@@ -27,6 +27,7 @@ export const ArmStateKeys = {
     customAzureResource: azureResourceManagerCreateStateSymbol("azureCustomResource"),
     armFeature: azureResourceManagerCreateStateSymbol("armFeature"),
     armFeatureSet: azureResourceManagerCreateStateSymbol("armFeatureSet"),
+    armFeatureFileSet: azureResourceManagerCreateStateSymbol("armFeatureFileSet"),
     armFeatureOptions: azureResourceManagerCreateStateSymbol("armFeatureOptions"),
     // private.decorator.ts
     azureResourceBase: azureResourceManagerCreateStateSymbol("azureResourceBase"),
@@ -39,5 +40,7 @@ export const ArmStateKeys = {
     armExternalType: azureResourceManagerCreateStateSymbol("armExternalType"),
     inlineAzureType: azureResourceManagerCreateStateSymbol("inlineAzureType"),
     genericResource: azureResourceManagerCreateStateSymbol("genericResource"),
+    // base-types.ts
+    azureBaseTypes: azureResourceManagerCreateStateSymbol("azureBaseTypes"),
 };
 //# sourceMappingURL=state.js.map

package/dist/src/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAqB;AACrB,2DAA2D;AAC3D,SAAS,qCAAqC,CAAC,IAAY;IACzD,OAAO,MAAM,CAAC,GAAG,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,2BAA2B,EAAE,qCAAqC,CAAC,6BAA6B,CAAC;IACjG,qBAAqB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAClF,YAAY,EAAE,qCAAqC,CAAC,cAAc,CAAC;IACnE,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,cAAc,EAAE,qCAAqC,CAAC,gBAAgB,CAAC;IACvE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IAErF,cAAc;IACd,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,kBAAkB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAC/E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,gBAAgB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAC9E,kBAAkB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAChF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,UAAU,EAAE,qCAAqC,CAAC,YAAY,CAAC;IAC/D,aAAa,EAAE,qCAAqC,CAAC,eAAe,CAAC;IACrE,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAE7E,uBAAuB;IACvB,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAC7E,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IAEnF,oCAAoC;IACpC,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,sBAAsB,EAAE,qCAAqC,CAAC,wBAAwB,CAAC;IACvF,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;CAC1E,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAqB;AACrB,2DAA2D;AAC3D,SAAS,qCAAqC,CAAC,IAAY;IACzD,OAAO,MAAM,CAAC,GAAG,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,2BAA2B,EAAE,qCAAqC,CAAC,6BAA6B,CAAC;IACjG,qBAAqB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAClF,YAAY,EAAE,qCAAqC,CAAC,cAAc,CAAC;IACnE,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,cAAc,EAAE,qCAAqC,CAAC,gBAAgB,CAAC;IACvE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,wBAAwB,EAAE,qCAAqC,CAAC,0BAA0B,CAAC;IAC3F,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IAErF,cAAc;IACd,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,kBAAkB,EAAE,qCAAqC,CAAC,oBAAoB,CAAC;IAC/E,qBAAqB,EAAE,qCAAqC,CAAC,uBAAuB,CAAC;IACrF,gBAAgB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAC9E,kBAAkB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IAChF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,UAAU,EAAE,qCAAqC,CAAC,YAAY,CAAC;IAC/D,aAAa,EAAE,qCAAqC,CAAC,eAAe,CAAC;IACrE,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAC7E,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAE7E,uBAAuB;IACvB,iBAAiB,EAAE,qCAAqC,CAAC,mBAAmB,CAAC;IAC7E,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IAEnF,oCAAoC;IACpC,oBAAoB,EAAE,qCAAqC,CAAC,sBAAsB,CAAC;IACnF,mBAAmB,EAAE,qCAAqC,CAAC,qBAAqB,CAAC;IACjF,sBAAsB,EAAE,qCAAqC,CAAC,wBAAwB,CAAC;IACvF,gBAAgB,EAAE,qCAAqC,CAAC,kBAAkB,CAAC;IAC3E,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IACzE,eAAe,EAAE,qCAAqC,CAAC,iBAAiB,CAAC;IAEzE,gBAAgB;IAChB,cAAc,EAAE,qCAAqC,CAAC,gBAAgB,CAAC;CACxE,CAAC"}

package/dist/src/tsp-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsp-index.d.ts","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"tsp-index.d.ts","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/tsp-index.js

@@ -1,7 +1,8 @@
+import { $azureBaseType } from "./base-types.js";
 import { $armCommonTypesVersion, $externalTypeRef } from "./common-types.js";
 import { $armLibraryNamespace, $armProviderNamespace, $useLibraryNamespace } from "./namespace.js";
 import { $armOperationRoute, $armResourceAction, $armResourceCheckExistence, $armResourceCollectionAction, $armResourceCreateOrUpdate, $armResourceDelete, $armResourceList, $armResourceRead, $armResourceUpdate, $renamePathParameter, } from "./operations.js";
-import { $armExternalType, $armProviderNameValue, $armResourceOperations, $armVirtualResource, $customAzureResource, $extensionResource, $feature, $featureOptions, $features, $identifiers, $locationResource, $resourceBaseType, $resourceGroupResource, $singleton, $subscriptionResource, $tenantResource, } from "./resource.js";
+import { $armExternalType, $armProviderNameValue, $armResourceOperations, $armVirtualResource, $customAzureResource, $extensionResource, $feature, $featureFile, $featureFileOptions, $featureFiles, $featureOptions, $features, $identifiers, $locationResource, $resourceBaseType, $resourceGroupResource, $singleton, $subscriptionResource, $tenantResource, } from "./resource.js";
 export { $lib } from "./lib.js";
 /** @internal */
 export const $decorators = {
@@ -29,6 +30,12 @@ export const $decorators = {
         armVirtualResource: $armVirtualResource,
         resourceBaseType: $resourceBaseType,
         identifiers: $identifiers,
+        featureFile: $featureFile,
+        featureFiles: $featureFiles,
+        featureFileOptions: $featureFileOptions,
+    },
+    "Azure.ResourceManager.BaseTypes": {
+        azureBaseType: $azureBaseType,
     },
     "Azure.ResourceManager.Legacy": {
         customAzureResource: $customAzureResource,

package/dist/src/tsp-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"tsp-index.js","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,uBAAuB,EAAE;QACvB,2BAA2B,EAAE,4BAA4B;QACzD,oBAAoB,EAAE,qBAAqB;QAC3C,oBAAoB,EAAE,qBAAqB;QAC3C,mBAAmB,EAAE,oBAAoB;QACzC,mBAAmB,EAAE,oBAAoB;QACzC,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,eAAe;QAC/B,oBAAoB,EAAE,qBAAqB;QAC3C,gBAAgB,EAAE,iBAAiB;QACnC,qBAAqB,EAAE,sBAAsB;QAC7C,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,yBAAyB,EAAE,0BAA0B;QACrD,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,yBAAyB,EAAE,0BAA0B;QACrD,qBAAqB,EAAE,sBAAsB;QAC7C,qBAAqB,EAAE,sBAAsB;QAC7C,kBAAkB,EAAE,mBAAmB;QACvC,gBAAgB,EAAE,iBAAiB;QACnC,WAAW,EAAE,YAAY;KACe;IAC1C,8BAA8B,EAAE;QAC9B,mBAAmB,EAAE,oBAAoB;QACzC,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,mBAAmB,EAAE,oBAAoB;QACzC,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,eAAe;KACe;CACjD,CAAC"}
+{"version":3,"file":"tsp-index.js","sourceRoot":"","sources":["../../src/tsp-index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,uBAAuB,EAAE;QACvB,2BAA2B,EAAE,4BAA4B;QACzD,oBAAoB,EAAE,qBAAqB;QAC3C,oBAAoB,EAAE,qBAAqB;QAC3C,mBAAmB,EAAE,oBAAoB;QACzC,mBAAmB,EAAE,oBAAoB;QACzC,SAAS,EAAE,UAAU;QACrB,cAAc,EAAE,eAAe;QAC/B,oBAAoB,EAAE,qBAAqB;QAC3C,gBAAgB,EAAE,iBAAiB;QACnC,qBAAqB,EAAE,sBAAsB;QAC7C,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,yBAAyB,EAAE,0BAA0B;QACrD,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,yBAAyB,EAAE,0BAA0B;QACrD,qBAAqB,EAAE,sBAAsB;QAC7C,qBAAqB,EAAE,sBAAsB;QAC7C,kBAAkB,EAAE,mBAAmB;QACvC,gBAAgB,EAAE,iBAAiB;QACnC,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,YAAY;QACzB,YAAY,EAAE,aAAa;QAC3B,kBAAkB,EAAE,mBAAmB;KACC;IAC1C,iCAAiC,EAAE;QACjC,aAAa,EAAE,cAAc;KACoB;IACnD,8BAA8B,EAAE;QAC9B,mBAAmB,EAAE,oBAAoB;QACzC,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;QACjC,mBAAmB,EAAE,oBAAoB;QACzC,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,eAAe;KACe;CACjD,CAAC"}

package/lib/arm.tsp

@@ -12,6 +12,8 @@ import "./legacy-types/arm.legacy.tsp";
 import "./common-types/common-types.tsp";
 import "./extension/extension.tsp";
 import "./backcompat.tsp";
+import "./base-types/base-types.tsp";
+import "./base-types/agent.tsp";
 import "./private.decorators.tsp";
 import "./models.tsp";
 import "./operations.tsp";

package/lib/base-types/agent.tsp

@@ -0,0 +1,425 @@
+import "./base-types.tsp";
+
+using Azure.ResourceManager;
+using Azure.ResourceManager.BaseTypes;
+using Azure.ResourceManager.Private;
+using TypeSpec.Rest;
+
+namespace Azure.ResourceManager.BaseTypes.Agents;
+
+// ============================================================================
+// Agent Tool Types
+// ============================================================================
+
+/**
+ * A tool binding for an agent (Appliance deployment model).
+ * All properties are read-only (the appliance owns and reports state).
+ */
+model AgentToolTypeAppliance {
+  /** Tool type discriminator. Must be one of the publicly documented Azure AI Foundry tool types. */
+  @visibility(Lifecycle.Read)
+  type: string;
+
+  /** Tool name/identifier. */
+  @visibility(Lifecycle.Read)
+  name: string;
+}
+
+/**
+ * A tool binding for an agent (Platform deployment model).
+ * All properties have default visibility (the client owns these fields).
+ */
+model AgentToolTypePlatform {
+  /** Tool type discriminator. Must be one of the publicly documented Azure AI Foundry tool types. */
+  type: string;
+
+  /** Tool name/identifier. */
+  name: string;
+}
+
+// ============================================================================
+// Agent Definition
+// ============================================================================
+
+/**
+ * Inline agent definition describing the model and behavior of the agent.
+ * This model is used only as a constraint for template parameters.
+ */
+internal model AgentDefinition {
+  /** Model identifier (RP-defined). */
+  `model`: string;
+
+  /** System prompt / behavioral instructions for the agent. */
+  instructions: string;
+}
+
+/**
+ * Appliance deployment model of AgentDefinition.
+ * Properties controlled by `@baseTypeOptional` are invisible when the corresponding
+ * template parameter is false, or read-only when present.
+ * @template HasModelDeploymentRef Whether the modelDeploymentRef property is present.
+ * @template HasInstructions Whether the instructions property is present.
+ */
+model AgentDefinitionAppliance<
+  HasModelDeploymentRef extends valueof boolean = false,
+  HasInstructions extends valueof boolean = false
+> {
+  /** Model identifier (RP-defined). */
+  @visibility(Lifecycle.Read)
+  `model`: string;
+
+  /** System prompt / behavioral instructions for the agent. */
+  @baseTypeOptional(HasInstructions, true)
+  instructions: string;
+
+  /** Optional RP-specific reference to an underlying model deployment. */
+  @baseTypeOptional(HasModelDeploymentRef, true)
+  modelDeploymentRef?: string;
+}
+
+/**
+ * Platform deployment model of AgentDefinition.
+ * Properties controlled by `@baseTypeOptional` are invisible when the corresponding
+ * template parameter is false, or have default visibility when present.
+ * @template HasModelDeploymentRef Whether the modelDeploymentRef property is present.
+ * @template HasInstructions Whether the instructions property is present.
+ */
+model AgentDefinitionPlatform<
+  HasModelDeploymentRef extends valueof boolean = false,
+  HasInstructions extends valueof boolean = false
+> {
+  /** Model identifier (RP-defined). */
+  `model`: string;
+
+  /** System prompt / behavioral instructions for the agent. */
+  @baseTypeOptional(HasInstructions, false)
+  instructions: string;
+
+  /** Optional RP-specific reference to an underlying model deployment. */
+  @baseTypeOptional(HasModelDeploymentRef, false)
+  modelDeploymentRef?: string;
+}
+
+// ============================================================================
+// Agent Properties (resource property bag)
+// ============================================================================
+
+/**
+ * Required properties for an agent resource.
+ * This model is used only as a constraint for template parameters.
+ */
+internal model AgentProperties {
+  /** ARM-managed. Must include the base type descriptor for this resource. */
+  @visibility(Lifecycle.Read)
+  baseTypes: BaseTypeInfo[];
+
+  /** Human-friendly name. */
+  displayName: string;
+
+  /** Purpose/behavior summary. */
+  description: string;
+
+  /** Inline agent definition (must extend AgentDefinition). */
+  definition: AgentDefinition;
+}
+
+/**
+ * Appliance deployment model of AgentProperties.
+ * All properties are read-only (the appliance owns and reports state).
+ * @template AgentDefinitionType The user-defined agent definition model (must extend AgentDefinition).
+ */
+model AgentPropertiesAppliance<AgentDefinitionType extends AgentDefinition> {
+  /** ARM-managed. Must include the base type descriptor for this resource. */
+  @visibility(Lifecycle.Read)
+  baseTypes: BaseTypeInfo[];
+
+  /** Human-friendly name. */
+  @visibility(Lifecycle.Read)
+  displayName: string;
+
+  /** Purpose/behavior summary. */
+  @visibility(Lifecycle.Read)
+  description: string;
+
+  /** Inline agent definition. */
+  @visibility(Lifecycle.Read)
+  definition: AgentDefinitionType;
+
+  /** Tool bindings. Read-only in the Appliance deployment model. */
+  @visibility(Lifecycle.Read)
+  tools?: AgentToolTypeAppliance[];
+}
+
+/**
+ * Platform deployment model of AgentProperties.
+ * Properties have default visibility (the client owns these fields).
+ * baseTypes remains ARM-managed and read-only.
+ * @template AgentDefinitionType The user-defined agent definition model (must extend AgentDefinition).
+ */
+model AgentPropertiesPlatform<AgentDefinitionType extends AgentDefinition> {
+  /** ARM-managed. Must include the base type descriptor for this resource. */
+  @visibility(Lifecycle.Read)
+  baseTypes: BaseTypeInfo[];
+
+  /** Human-friendly name. */
+  displayName: string;
+
+  /** Purpose/behavior summary. */
+  description: string;
+
+  /** Inline agent definition. */
+  definition: AgentDefinitionType;
+
+  /** Tool bindings. Writable in the Platform deployment model. */
+  tools?: AgentToolTypePlatform[];
+}
+
+// ============================================================================
+// Conversation Types
+// ============================================================================
+
+/**
+ * Properties for a conversation resource holding the items and metadata
+ * exchanged between a client and an agent.
+ */
+model ConversationProperties {
+  /** Timestamp of when the conversation was created. Read-only. */
+  @visibility(Lifecycle.Read)
+  createdAt?: utcDateTime;
+}
+
+/**
+ * The role of the author of a message item.
+ */
+enum MessageRole {
+  /** A developer-authored instruction message. */
+  Developer,
+
+  /** A message authored by the end user. */
+  User,
+
+  /** A message generated by the assistant (agent). */
+  Assistant,
+
+  /** A message representing the output of a tool. */
+  Tool,
+}
+
+/**
+ * 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,
+}
+
+/**
+ * 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;
+}
+
+// ============================================================================
+// Response Types
+// ============================================================================
+
+/**
+ * The status of a response.
+ */
+@Azure.Core.lroStatus
+union ResponseStatus {
+  /** The response completed successfully. */
+  @Azure.Core.lroSucceeded
+  Completed: "Completed",
+
+  /** The response failed. */
+  @Azure.Core.lroFailed
+  Failed: "Failed",
+
+  /** The response was cancelled. */
+  @Azure.Core.lroCanceled
+  Cancelled: "Cancelled",
+
+  /** The response is incomplete. */
+  Incomplete: "Incomplete",
+
+  /** The response is queued for execution. */
+  Queued: "Queued",
+
+  /** The response is in progress. */
+  InProgress: "InProgress",
+
+  string,
+}
+
+/**
+ * Properties for a response generated by an agent for a given input,
+ * including its output, status, and usage.
+ */
+model ResponseProperties {
+  /** Timestamp of when the response was created. Read-only. */
+  @visibility(Lifecycle.Read)
+  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;
+
+  /** The status of the response. Read-only. */
+  @visibility(Lifecycle.Read)
+  status?: ResponseStatus;
+
+  /** Content input to the model. Required on create. */
+  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 ResponseItem {
+  /** Unique identifier of the output item. Read-only. */
+  @visibility(Lifecycle.Read)
+  id?: string;
+
+  /** The item type discriminator. Read-only. */
+  @visibility(Lifecycle.Read)
+  type?: ItemType;
+
+  /** The role of the message author. Applies to `Message` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  role?: MessageRole;
+
+  /** The text content of the message. Applies to `Message` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  content?: string;
+
+  /** Identifier correlating a function call with its output. Applies to `FunctionCall` and `FunctionCallOutput` items. Read-only. */
+  @visibility(Lifecycle.Read)
+  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: ResponseItem[];
+}
+
+/** Mix-in for the previousResponseId property. */
+model PreviousResponseProperty {
+  /** ID of a previous response for multi-turn chaining. Writable on create. */
+  previousResponseId?: string;
+}
+
+/** Mix-in for response instructions. */
+model ResponseInstructionsProperty {
+  /** System/developer message for this response. Writable on create; overrides agent-level instructions for this invocation. */
+  instructions?: string;
+}
+
+// ============================================================================
+// Resource Templates
+// ============================================================================
+
+/**
+ * Model template for an Agent tracked resource.
+ * Applies the Agent base type decorator automatically.
+ * @template Properties RP-specific properties for the agent (must extend AgentProperties)
+ */
+@azureBaseType(#{ baseType: "Agent", version: "2024-06-01" })
+model Agent<Properties extends AgentProperties> is TrackedResource<Properties>;
+
+/**
+ * Model template for a Conversation child resource of an Agent.
+ * @template Properties RP-specific properties for the conversation (must extend ConversationProperties)
+ * @template AgentResource The parent Agent resource type
+ */
+@parentResource(AgentResource)
+model AgentConversation<
+  Properties extends ConversationProperties,
+  AgentResource extends Foundations.Resource
+> is ProxyResource<Properties>;
+
+/**
+ * Model template for a Response child resource of an Agent.
+ * @template Properties RP-specific properties for the response (must extend ResponseProperties)
+ * @template AgentResource The parent Agent resource type
+ */
+@parentResource(AgentResource)
+model AgentResponse<
+  Properties extends ResponseProperties,
+  AgentResource extends Foundations.Resource
+> is ProxyResource<Properties>;

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

@@ -0,0 +1,45 @@
+using Reflection;
+
+namespace Azure.ResourceManager.BaseTypes;
+
+/**
+ * An ARM-managed base type descriptor identifying the schema contract a resource conforms to.
+ * Used as a parameter to the `@azureBaseType` decorator to indicate which
+ * base types a resource conforms to.
+ */
+model BaseTypeInfo {
+  /** The base type identifier (for example, "Agent"). */
+  baseType: string;
+
+  /** The schema version of the base type. */
+  version: string;
+}
+
+/**
+ * `@azureBaseType` marks an Azure Resource Manager resource properties model as implementing
+ * a base type. Base types define structured constraints including required and
+ * optional properties that conforming resources must implement.
+ *
+ * This decorator may be applied multiple times to indicate conformance to
+ * multiple base types. Duplicate entries are ignored.
+ *
+ * @param baseType The base type specification this resource implements.
+ *
+ * @example
+ *
+ * ```typespec
+ * // 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;