feat: support RK examples and env-driven default base URL

Author: nedasvi

CONTRIBUTING.md

@@ -14,10 +14,11 @@ sdk.dir=/path/to/Android/sdk
 5. If you want to run the sample app against the live backend, add your API key to `local.properties`:
 
 ```properties
-resolvekit.apiKey=iaa_your_key_here
+resolvekit.apiKey=rk_your_key_here
+resolvekit.baseUrl=https://agent.example.com
 ```
 
-You can also export `RESOLVEKIT_API_KEY` instead of writing it to `local.properties`.
+You can also export `RESOLVEKIT_API_KEY` and `RESOLVEKIT_BASE_URL` instead of writing them to `local.properties`.
 
 For local publishing credentials, copy [.env.example](.env.example) to `.env` and fill in the values you need. Use a base64-encoded private key in `SIGNING_KEY_BASE64`. Keep `.env` local only.
 

README.md

@@ -144,7 +144,7 @@ Gradle will substitute the local modules automatically.
 ```kotlin
 val runtime = ResolveKitRuntime(
     configuration = ResolveKitConfiguration(
-        apiKeyProvider = { "iaa_your_key_here" },
+        apiKeyProvider = { "rk_your_key_here" },
         functions = listOf(GetCurrentTime)
     ),
     context = applicationContext
@@ -164,7 +164,7 @@ startActivity(
     ResolveKitChatActivity.createIntent(
         context = this,
         configuration = ResolveKitConfiguration(
-            apiKeyProvider = { "iaa_your_key_here" },
+            apiKeyProvider = { "rk_your_key_here" },
             functions = listOf(GetCurrentTime)
         )
     )
@@ -179,7 +179,7 @@ supportFragmentManager.beginTransaction()
         R.id.container,
         ResolveKitChatFragment.newInstance(
             ResolveKitConfiguration(
-                apiKeyProvider = { "iaa_your_key_here" },
+                apiKeyProvider = { "rk_your_key_here" },
                 functions = listOf(GetCurrentTime)
             )
         )
@@ -381,7 +381,8 @@ sdk.dir=/path/to/Android/sdk
 3. If you want to run the sample app, also add:
 
 ```properties
-resolvekit.apiKey=iaa_your_key_here
+resolvekit.apiKey=rk_your_key_here
+resolvekit.baseUrl=https://agent.example.com
 ```
 
 4. Select the `sample` run configuration or run:
@@ -484,3 +485,4 @@ This repo includes:
 - `local.properties` is intentionally ignored.
 - Do not commit API keys or publishing credentials.
 - Public API changes should be reflected in this README.
+- `RESOLVEKIT_BASE_URL` (or `resolvekit.baseUrl` in `local.properties`) controls the backend URL used by the sample app.

sample/build.gradle.kts

@@ -13,6 +13,9 @@ val localProps = Properties().apply {
 fun apiKey() = System.getenv("RESOLVEKIT_API_KEY")
     ?: localProps.getProperty("resolvekit.apiKey")
     ?: ""
+fun baseUrl() = System.getenv("RESOLVEKIT_BASE_URL")
+    ?: localProps.getProperty("resolvekit.baseUrl")
+    ?: "https://agent.example.com"
 
 android {
     namespace = "app.resolvekit.sample"
@@ -26,6 +29,7 @@ android {
         versionName = "1.0.0"
 
         buildConfigField("String", "RESOLVEKIT_API_KEY", "\"${apiKey()}\"")
+        buildConfigField("String", "RESOLVEKIT_BASE_URL", "\"${baseUrl()}\"")
     }
 
     buildFeatures {

sample/src/main/kotlin/app/resolvekit/sample/MainActivity.kt

@@ -13,13 +13,14 @@ import app.resolvekit.ui.ResolveKitRuntime
  *
  * Set RESOLVEKIT_API_KEY in your environment (or local.properties) before
  * running:
- *   RESOLVEKIT_API_KEY=iaa_... ./gradlew :sample:installDebug
+ *   RESOLVEKIT_API_KEY=rk_... ./gradlew :sample:installDebug
  */
 class MainActivity : ComponentActivity() {
 
     private val runtime by lazy {
         ResolveKitRuntime(
             configuration = ResolveKitConfiguration(
+                baseUrl = BuildConfig.RESOLVEKIT_BASE_URL,
                 apiKeyProvider = { BuildConfig.RESOLVEKIT_API_KEY.takeIf { it.isNotBlank() } },
                 llmContextProvider = {
                     // Provide custom context to shape LLM responses

ui/src/main/kotlin/app/resolvekit/ui/ResolveKitConfiguration.kt

@@ -4,6 +4,24 @@ import app.resolvekit.core.AnyResolveKitFunction
 import app.resolvekit.core.JSONObject
 import app.resolvekit.core.ResolveKitFunctionPack
 
+object ResolveKitDefaults {
+    const val BASE_URL_ENV_KEY = "RESOLVEKIT_BASE_URL"
+    const val fallbackBaseUrl = "https://agent.example.com"
+
+    internal fun resolveBaseUrl(
+        envLookup: (String) -> String? = System::getenv,
+        propertyLookup: (String) -> String? = System::getProperty
+    ): String {
+        val configured = sequenceOf(
+            propertyLookup(BASE_URL_ENV_KEY),
+            envLookup(BASE_URL_ENV_KEY)
+        ).firstOrNull { !it.isNullOrBlank() }?.trim()
+        return configured ?: fallbackBaseUrl
+    }
+
+    val baseUrl: String = resolveBaseUrl()
+}
+
 /**
  * Immutable configuration for [ResolveKitRuntime].
  *
@@ -24,7 +42,7 @@ import app.resolvekit.core.ResolveKitFunctionPack
  * @param functionPacks        Grouped tool modules; all functions in each pack are registered.
  */
 data class ResolveKitConfiguration(
-    val baseUrl: String = "https://agent.example.com",
+    val baseUrl: String = ResolveKitDefaults.baseUrl,
     val apiKeyProvider: () -> String?,
     val deviceIdProvider: (() -> String?)? = null,
     val llmContextProvider: () -> JSONObject = { emptyMap() },

ui/src/test/kotlin/app/resolvekit/ui/ResolveKitRuntimeTest.kt

@@ -60,7 +60,16 @@ class ResolveKitRuntimeTest {
     @Test
     fun `configuration defaults to neutral self-host base URL`() {
         val config = ResolveKitConfiguration(apiKeyProvider = { "test-key" })
-        assertEquals("https://agent.example.com", config.baseUrl)
+        assertEquals(ResolveKitDefaults.fallbackBaseUrl, config.baseUrl)
+    }
+
+    @Test
+    fun `configuration default base URL supports environment override`() {
+        val resolved = ResolveKitDefaults.resolveBaseUrl(
+            envLookup = { null },
+            propertyLookup = { if (it == ResolveKitDefaults.BASE_URL_ENV_KEY) "https://agent.selfhost.example.com" else null }
+        )
+        assertEquals("https://agent.selfhost.example.com", resolved)
     }
 
     @Test