Add base OpenAI TypeSpec specification (#585)

 Add base TypeSpec

Author: ShivangiReja

.gitignore

@@ -178,8 +178,11 @@ artifacts
 # Temporary typespec folders for typespec generation
 TempTypeSpecFiles/
 
-# Base specification files
-specification/base/
+# Azure specification files
+specification/base/entrypoints/azure.v1
+specification/base/entrypoints/sdk.dotnet.azure
+specification/base/typespec.azure
+specification/base/typespec.azure.v1
 
 # Generator default TypeSpec output
 codegen/tsp-output/

scripts/Invoke-CodeGen.ps1

@@ -1,4 +1,4 @@
-[CmdletBinding(DefaultParameterSetName = 'GitHub')]
+[CmdletBinding(DefaultParameterSetName = 'Default')]
 param(
     [Parameter(Mandatory = $true, ParameterSetName = 'GitHub')]
     [string]$GitHubOwner,
@@ -214,42 +214,54 @@ $codegenFolderPath = Join-Path $repoRootPath "codegen"
 
 $scriptStartTime = Get-Date
 
-$shouldDownload = $true
-if (Test-Path $baseSpecificationFolderPath) {
-    Write-Host "Base specification already exists at: $baseSpecificationFolderPath"
+if ($PSCmdlet.ParameterSetName -eq 'Default') {
+    if (-not (Test-Path $baseSpecificationFolderPath)) {
+        Write-Error "Base specification path does not exist: $baseSpecificationFolderPath"
+        throw "Default specification path not found"
+    }
+
+    Write-Host "Using existing base specification at: $baseSpecificationFolderPath"
     Write-Host ""
+}
+else {
+    $shouldDownload = $true
 
-    if ($Force) {
-        Write-Host "Overwriting existing base specification..."
+    if (Test-Path $baseSpecificationFolderPath) {
+        Write-Host "Base specification already exists at: $baseSpecificationFolderPath"
         Write-Host ""
-        Remove-Item -Path $baseSpecificationFolderPath -Recurse -Force
-    }
-    else {
-        $shouldDownload = $false
+
+        if ($Force) {
+            Write-Host "Overwriting existing base specification..."
+            Write-Host ""
+            Remove-Item -Path $baseSpecificationFolderPath -Recurse -Force
+        }
+        else {
+            $shouldDownload = $false
+        }
     }
-}
 
-if ($shouldDownload) {
-    Write-Host "Retrieving base specification..."
-    Write-Host ""
+    if ($shouldDownload) {
+        Write-Host "Retrieving base specification..."
+        Write-Host ""
 
-    if ($PSCmdlet.ParameterSetName -eq 'GitHub') {
-        $success = Get-GitHubRepoContent -GitHubOwner $GitHubOwner `
-            -GitHubRepository $GitHubRepository `
-            -CommitHash $CommitHash `
-            -GitHubToken $GitHubToken `
-            -SubdirectoryPath "openai-in-typespec" `
-            -Destination $baseSpecificationFolderPath
-    }
-    elseif ($PSCmdlet.ParameterSetName -eq 'Local') {
-        $success = Get-LocalRepoContent -LocalRepositoryPath $LocalRepositoryPath `
-            -SubdirectoryPath "openai-in-typespec" `
-            -Destination $baseSpecificationFolderPath
-    }
+        if ($PSCmdlet.ParameterSetName -eq 'GitHub') {
+            $success = Get-GitHubRepoContent -GitHubOwner $GitHubOwner `
+                -GitHubRepository $GitHubRepository `
+                -CommitHash $CommitHash `
+                -GitHubToken $GitHubToken `
+                -SubdirectoryPath "openai-in-typespec" `
+                -Destination $baseSpecificationFolderPath
+        }
+        elseif ($PSCmdlet.ParameterSetName -eq 'Local') {
+            $success = Get-LocalRepoContent -LocalRepositoryPath $LocalRepositoryPath `
+                -SubdirectoryPath "openai-in-typespec" `
+                -Destination $baseSpecificationFolderPath
+        }
 
-    if (-not $success) {
-        Write-Error "Failed to get repository contents."
-        throw "Repository content retrieval failed."
+        if (-not $success) {
+            Write-Error "Failed to get repository contents."
+            throw "Repository content retrieval failed."
+        }
     }
 }
 

specification/base/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

specification/base/.gitignore

@@ -0,0 +1 @@
+codegen_blackhole/

specification/base/entrypoints/sdk.dotnet/main.tsp

@@ -0,0 +1,5 @@
+// Import order matters. Somehow, importing the server decorated namespace afterwards,
+// will cause the the `description` field to be missing in the generated OpenAPI spec.
+import "./specialized-types.tsp";
+import "../../typespec/servers/rest.tsp";
+import "../../typespec";

specification/base/entrypoints/sdk.dotnet/specialized-types.tsp

@@ -0,0 +1,44 @@
+namespace OpenAI;
+
+// .NET code generation doesn't yet support many-to-one mappings of discriminators; here, we substitute one-to-one
+// model mappings that would unnecessarily complicate OpenAPI emission.
+
+@discriminator("type")
+model ComparisonFilter {
+  type: "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
+  key: string;
+  value: string | float32 | boolean;
+}
+
+model ComparisonFilterEquals extends ComparisonFilter {
+  type: "eq";
+}
+model ComparisonFilterNotEquals extends ComparisonFilter {
+  type: "ne";
+}
+model ComparisonFilterGreaterThan extends ComparisonFilter {
+  type: "gt";
+}
+model ComparisonFilterGreaterThanOrEquals extends ComparisonFilter {
+  type: "gte";
+}
+model ComparisonFilterLessThan extends ComparisonFilter {
+  type: "lt";
+}
+model ComparisonFilterLessThanOrEquals extends ComparisonFilter {
+  type: "lte";
+}
+
+@discriminator("type")
+model CompoundFilter {
+  type: "and" | "or";
+  filters: (ComparisonFilter | CompoundFilter)[];
+}
+model CompoundFilterAnd extends CompoundFilter {
+  type: "and";
+}
+model CompoundFilterOr extends CompoundFilter {
+  type: "or";
+}
+
+alias VectorStoreFileAttributes = Record<unknown>;