Added/updates samples, Added TTL checks, Changed Native Mode AI Header

Author: randersenYB

AIContext/AIContextVersion.cs

@@ -2,6 +2,6 @@ namespace Aerospike.Database.LINQPadDriver.Extensions
 {
 	public static class AIContextVersion
 	{
-		public const string Current = "2026.07.17.01";
+		public const string Current = "2026.07.21.03";
 	}
 }

Aerospike.Database.LINQPadDriver.csproj

@@ -20,8 +20,8 @@
     <Deterministic>true</Deterministic>
 
     <!-- Current validated package version. Increment for the next release. -->
-    <Version>7.0.53.18</Version>
-    <FileVersion>7.0.53.18</FileVersion>
+    <Version>7.0.53.22</Version>
+    <FileVersion>7.0.53.22</FileVersion>
     <VersionSuffix Condition="'$(Configuration)' == 'Debug'">debug</VersionSuffix>
     <InformationalVersion Condition="'$(Configuration)' == 'Debug'">$(Version)-debug</InformationalVersion>
     <InformationalVersion Condition="'$(Configuration)' != 'Debug'">$(Version)</InformationalVersion>

Driver/Aerospike.Database.LINQPadDriver.7.0.53.22.nupkg

@@ -476,16 +476,23 @@ private static AIGeneratedQueryMode DetermineGeneratedQueryMode(
 			var hasMediumNativeCue = HasMediumNativeModeCue(requestText);
 			var hasDriverCue = HasDriverModeCue(requestText);
 
-			if((hasStrongNativeCue || hasMediumNativeCue) && hasDriverCue)
+			if(hasStrongNativeCue)
+			{
+				if(hasDriverCue)
+				{
+					modeWarning = "Mode conflict detected (native and driver cues). Honoring explicit native intent from the request.";
+				}
+
+				return AIGeneratedQueryMode.NativeAerospikeClient;
+			}
+
+			if(hasMediumNativeCue && hasDriverCue)
 			{
 				modeWarning = "Mode conflict detected (native and driver cues). Defaulting to LINQPad Driver mode. Add mode:native or mode:driver to force mode selection.";
 				return AIGeneratedQueryMode.Driver;
 			}
 
-			if(hasStrongNativeCue)
-				return AIGeneratedQueryMode.NativeAerospikeClient;
-
-			if(hasMediumNativeCue && !hasDriverCue)
+			if(hasMediumNativeCue)
 				return AIGeneratedQueryMode.NativeAerospikeClient;
 
 			return AIGeneratedQueryMode.Driver;
@@ -523,6 +530,7 @@ private static bool HasStrongNativeModeCue(string text)
 				|| text.Contains("native Aerospike API", StringComparison.OrdinalIgnoreCase)
 				|| text.Contains("native Aerospike C# client", StringComparison.OrdinalIgnoreCase)
 				|| text.Contains("native C# client", StringComparison.OrdinalIgnoreCase)
+				|| text.Contains("native API code", StringComparison.OrdinalIgnoreCase)
 				|| text.Contains("native API driver", StringComparison.OrdinalIgnoreCase)
 				|| text.Contains("native driver", StringComparison.OrdinalIgnoreCase)
 				|| text.Contains("no LINQPad driver", StringComparison.OrdinalIgnoreCase)
@@ -598,11 +606,6 @@ private static string CreateGeneratedQuery(
 			{
 				generatedHeader = EnsureNativeAerospikeClientHeader("<Query Kind=\"Statements\" />");
 				normalizedCode = NormalizeNativeAerospikeClientCode(normalizedCode);
-				warningComment =
-					"// NOTE: Native Aerospike client mode. This query intentionally does not copy LINQPad driver connection metadata." + Environment.NewLine +
-					"// Confirm host, port, TLS, authentication, and policy settings before running." + Environment.NewLine +
-					"// The Aerospike.Client NuGet package is referenced in the LINQPad query header." + Environment.NewLine +
-					Environment.NewLine;
 			}
 			else if(TryGetCurrentQueryHeader(out var currentHeader))
 			{
@@ -1019,17 +1022,10 @@ private static string EnsureNativeAerospikeClientHeader(string header)
 		{
 			// Native Aerospike client generated queries are standalone LINQPad Statements queries.
 			// Do not depend on a copied LINQPad-driver connection header.
-			// Build the header explicitly so the Aerospike.Client NuGet reference cannot be lost
-			// when the source header is the self-closing form: <Query Kind="Statements" />.
 			var nativeHeader =
 				"<Query Kind=\"Statements\">" + Environment.NewLine +
 				"  <NuGetReference>Aerospike.Client</NuGetReference>" + Environment.NewLine +
-				"  <Namespace>System</Namespace>" + Environment.NewLine +
-				"  <Namespace>System.Collections</Namespace>" + Environment.NewLine +
-				"  <Namespace>System.Collections.Generic</Namespace>" + Environment.NewLine +
-				"  <Namespace>System.Linq</Namespace>" + Environment.NewLine +
-				"  <Namespace>System.Security.Authentication</Namespace>" + Environment.NewLine +
-				"  <Namespace>System.Security.Cryptography.X509Certificates</Namespace>" + Environment.NewLine +
+				"  <Namespace>Aerospike</Namespace>" + Environment.NewLine +
 				"  <Namespace>Aerospike.Client</Namespace>" + Environment.NewLine +
 				"</Query>";
 

Driver/Aerospike.Database.LINQPadDriver.LPX6

@@ -16,16 +16,31 @@ public class AIHelpersTests
 		/// Helper method to invoke private StripAIRequestCommentLines via reflection.
 		/// </summary>
 		private static string StripAIRequestCommentLines(string request)
+		{
+			return InvokePrivateStringMethod("StripAIRequestCommentLines", new object[] { request }, new[] { typeof(string) });
+		}
+
+		private static string EnsureNativeAerospikeClientHeader(string header)
+		{
+			return InvokePrivateStringMethod("EnsureNativeAerospikeClientHeader", new object[] { header }, new[] { typeof(string) });
+		}
+
+		private static object InvokePrivateMethod(string methodName, object[] args, Type[] parameterTypes)
 		{
 			var method = typeof(LINQPadAIGeneratedQuery).GetMethod(
-				"StripAIRequestCommentLines",
+				methodName,
 				BindingFlags.NonPublic | BindingFlags.Static,
 				null,
-				new[] { typeof(string) },
+				parameterTypes,
 				null);
 
-			Assert.IsNotNull(method, "StripAIRequestCommentLines method should exist");
-			return (string)method!.Invoke(null, new object[] { request })!;
+			Assert.IsNotNull(method, methodName + " method should exist");
+			return method!.Invoke(null, args);
+		}
+
+		private static string InvokePrivateStringMethod(string methodName, object[] args, Type[] parameterTypes)
+		{
+			return (string) InvokePrivateMethod(methodName, args, parameterTypes)!;
 		}
 
 		#region StripAIRequestCommentLines Tests
@@ -357,6 +372,88 @@ public void StripAIRequestCommentLines_ResultIsTrimmed()
 
 		#endregion
 
+		#region Native Header Generation
+
+		[TestMethod]
+		public void EnsureNativeAerospikeClientHeader_UsesMinimalStandaloneHeader()
+		{
+			// Arrange
+			const string inputHeader = "<Query Kind=\"Statements\" />";
+
+			// Act
+			var result = EnsureNativeAerospikeClientHeader(inputHeader);
+
+			// Assert
+			Assert.AreEqual(
+				"<Query Kind=\"Statements\">" + Environment.NewLine +
+				"  <NuGetReference>Aerospike.Client</NuGetReference>" + Environment.NewLine +
+				"  <Namespace>Aerospike</Namespace>" + Environment.NewLine +
+				"  <Namespace>Aerospike.Client</Namespace>" + Environment.NewLine +
+				"</Query>",
+				result);
+		}
+
+		[TestMethod]
+		public void EnsureNativeAerospikeClientHeader_DoesNotIncludeConnectionMetadata()
+		{
+			// Arrange
+			const string inputHeader = "<Query Kind=\"Statements\"><Connection><ID>abc</ID></Connection></Query>";
+
+			// Act
+			var result = EnsureNativeAerospikeClientHeader(inputHeader);
+
+			// Assert
+			Assert.IsFalse(result.Contains("<Connection>", StringComparison.Ordinal));
+			Assert.IsFalse(result.Contains("<ID>", StringComparison.Ordinal));
+			Assert.IsFalse(result.Contains("<CustomCxString>", StringComparison.Ordinal));
+			StringAssert.Contains(result, "<NuGetReference>Aerospike.Client</NuGetReference>");
+			StringAssert.Contains(result, "<Namespace>Aerospike</Namespace>");
+			StringAssert.Contains(result, "<Namespace>Aerospike.Client</Namespace>");
+		}
+
+		#endregion
+
+		#region Mode Detection
+
+		[TestMethod]
+		public void DetermineGeneratedQueryMode_StrongNativeAndDriverCue_PrefersNative()
+		{
+			// Arrange
+			const string request = "Can you translate this LINQPad driver query to native Aerospike C# client code using AsEnumerable()";
+			var args = new object[] { request, string.Empty, string.Empty, null };
+
+			// Act
+			var mode = InvokePrivateMethod(
+				"DetermineGeneratedQueryMode",
+				args,
+				new[] { typeof(string), typeof(string), typeof(string), typeof(string).MakeByRefType() });
+			var warning = (string) args[3];
+
+			// Assert
+			Assert.AreEqual("NativeAerospikeClient", mode!.ToString());
+			Assert.IsFalse(string.IsNullOrWhiteSpace(warning));
+			StringAssert.Contains(warning, "Honoring explicit native intent");
+		}
+
+		[TestMethod]
+		public void DetermineGeneratedQueryMode_NativeApiCodePhrase_PrefersNative()
+		{
+			// Arrange
+			const string request = "Can you translate this linq query into native API code, use filter expressions on invoice set: test.Customer.AsEnumerable().GroupJoin(...)";
+			var args = new object[] { request, string.Empty, string.Empty, null };
+
+			// Act
+			var mode = InvokePrivateMethod(
+				"DetermineGeneratedQueryMode",
+				args,
+				new[] { typeof(string), typeof(string), typeof(string), typeof(string).MakeByRefType() });
+
+			// Assert
+			Assert.AreEqual("NativeAerospikeClient", mode!.ToString());
+		}
+
+		#endregion
+
 		#region Edge Cases and Robustness
 
 		[TestMethod]

LINQPadAIGeneratedQuery.cs

@@ -77,13 +77,16 @@ Renders the current 'AIContext' as Markdown in LINQPad.
 9. '09-CDT-Nested-Query.linq'
 Demonstrates how to generate a query where the data is nested within multiple maps (documents).
 
+10. '10-Translate-LINQ-to-Native.linq'
+Demonstrates how to translate a LINQ query into Aerospike native API calls using server expressions.
+
 Recommended Additional Samples
 ------------------------------
 
 The following sample scripts are recommended additions based on the LINQPad AI
 overview deck and demo workflow.
 
-10. '10-Generate-Customer-Invoice-Artist-Purchase-Query.linq'
+11. '11-Generate-Customer-Invoice-Artist-Purchase-Query.linq'
 
 Purpose:
 Generate a LINQ query-syntax script that returns customers, their invoices, and
@@ -109,7 +112,7 @@ when those sets are available in the current connection metadata.
 - Generate a bounded result set with 'Take(...)'.
 - Use 'Dump()' for output.
 
-11. '11-Explain-AValue-TryApply-Customer-Query.linq'
+12. '12-Explain-AValue-TryApply-Customer-Query.linq'
 
 Purpose:
 Ask AI to explain an existing LINQPad Aerospike query and identify whether the
@@ -151,7 +154,7 @@ Expected AI behavior:
     string-indexer access when available.
     - Call out that server-side filtering may be more efficient for large sets.
 
-12. '12-Translate-TryApply-Query-To-Native-Server-Expression.linq'
+13. '13-Translate-TryApply-Query-To-Native-Server-Expression.linq'
 
 Purpose:
   Ask AI to translate a LINQPad-driver client-side AValue/TryApply query into

Publish/Aerospike.Database.LINQPadDriver.7.0.53.22.LPX6

@@ -24,7 +24,7 @@ Generate LINQPad C# Statements examples for AValue-backed properties.
 Use query syntax where practical.
 Use test.Customer.AsEnumerable().
 Show:
-1. A filter using FirstName.TryApply<string,bool>(name => name.StartsWith("a")).
+1. A filter using FirstName.TryApply<string,bool>(name => name.StartsWith("M")).
 2. A projection using FirstName.Apply<string,int>(name => name.Length).
 3. A numeric conversion example using CanConvert<decimal>() and Convert<decimal>().
 4. Use generated properties, not string-indexer access.