Add form-factor detection utility and layout contract interfaces

agent/app/src/main/java/com/example/appfunctions/agent/ui/contracts/AgentDemoScreenLayout.kt

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2026 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.example.appfunctions.agent.ui.contracts
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import com.example.appfunctions.agent.ui.screens.agentdemo.AgentUiEvent
+import com.example.appfunctions.agent.ui.screens.agentdemo.AgentUiState
+
+/**
+ * Mandatory interface contract for Agent Demo screen layouts.
+ * Both Mobile and TV implementations MUST conform to this contract.
+ */
+interface AgentDemoScreenLayout {
+    @Composable
+    fun Content(
+        uiState: AgentUiState,
+        onEvent: (AgentUiEvent) -> Unit,
+        initialSidePanelVisible: Boolean,
+        modifier: Modifier,
+    )
+}

agent/app/src/main/java/com/example/appfunctions/agent/ui/contracts/ConnectedAppsScreenLayout.kt

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2026 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.example.appfunctions.agent.ui.contracts
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import com.example.appfunctions.agent.ui.screens.agentdemo.ConnectedAppsUiState
+
+/**
+ * Mandatory interface contract for Connected Apps screen layouts.
+ * Both Mobile and TV implementations MUST conform to this contract.
+ */
+interface ConnectedAppsScreenLayout {
+    @Composable
+    fun Content(
+        uiState: ConnectedAppsUiState,
+        onBack: () -> Unit,
+        onToggleApp: (String, Boolean) -> Unit,
+        modifier: Modifier,
+    )
+}

agent/app/src/main/java/com/example/appfunctions/agent/ui/contracts/DebuggingScreenLayout.kt

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2026 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.example.appfunctions.agent.ui.contracts
+
+import android.app.PendingIntent
+import androidx.appfunctions.metadata.AppFunctionMetadata
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import com.example.appfunctions.agent.domain.appfunction.AppInfo
+import com.example.appfunctions.agent.ui.screens.debugging.DebuggingUiState
+
+/**
+ * Mandatory interface contract for Debugging screen layouts.
+ * Both Mobile and TV implementations MUST conform to this contract.
+ */
+interface DebuggingScreenLayout {
+    @Composable
+    fun Content(
+        uiState: DebuggingUiState,
+        onSearchQueryChanged: (String) -> Unit,
+        onAppSelected: (AppInfo) -> Unit,
+        onClearSelectedApp: () -> Unit,
+        onFunctionInputsChange: (String, Map<String, Any>) -> Unit,
+        onInvoke: (AppFunctionMetadata) -> Unit,
+        onClearResult: () -> Unit,
+        onFunctionExpandedChange: (String, Boolean) -> Unit,
+        onLaunchPendingIntent: (PendingIntent) -> Unit,
+        onTogglePin: (AppInfo) -> Unit,
+        modifier: Modifier,
+    )
+}

agent/app/src/main/java/com/example/appfunctions/agent/ui/contracts/SettingsScreenLayout.kt

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2026 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.example.appfunctions.agent.ui.contracts
+
+import androidx.compose.foundation.text.input.TextFieldState
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import com.example.appfunctions.agent.data.ServiceTier
+
+/**
+ * Mandatory interface contract for Settings screen layouts.
+ * Both Mobile and TV implementations MUST conform to this contract.
+ */
+interface SettingsScreenLayout {
+    @Composable
+    fun Content(
+        geminiApiKeyState: TextFieldState,
+        serviceTier: ServiceTier,
+        onServiceTierSelected: (ServiceTier) -> Unit,
+        onOpenLicenses: () -> Unit,
+        onNavigateToConnectedApps: () -> Unit,
+        modifier: Modifier,
+    )
+}

agent/app/src/main/java/com/example/appfunctions/agent/ui/layout/FormFactorUtils.kt

@@ -0,0 +1,47 @@
+/*
+ * Copyright 2026 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.example.appfunctions.agent.ui.layout
+
+import android.content.pm.PackageManager
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.compose.ui.platform.LocalContext
+
+enum class FormFactor {
+    MOBILE,
+    TV,
+    WEAR,
+    AUTO,
+    XR,
+}
+
+@Composable
+fun rememberFormFactor(): FormFactor {
+    val context = LocalContext.current
+    return remember(context) {
+        val pm = context.packageManager
+        when {
+            pm.hasSystemFeature(PackageManager.FEATURE_LEANBACK) -> FormFactor.TV
+            pm.hasSystemFeature(PackageManager.FEATURE_WATCH) -> FormFactor.WEAR
+            pm.hasSystemFeature(PackageManager.FEATURE_AUTOMOTIVE) -> FormFactor.AUTO
+            pm.hasSystemFeature("android.hardware.xr.display") -> FormFactor.XR
+            else -> FormFactor.MOBILE
+        }
+    }
+}
+
+@Composable
+fun isTvFormFactor(): Boolean = rememberFormFactor() == FormFactor.TV