feat: shared workspaces support

Add a `workspaceFilter` setting (defaults to `owner:me`) so users can
broaden the listing to include workspaces shared with them. The URI
handler now accepts an optional `owner` query parameter to disambiguate
workspaces by name across owners, and the environment list surfaces the
workspace owner as an environment information entry.

Generated with Coder Agents on behalf of @aslilac.

Author: aslilac

CHANGELOG.md

@@ -7,6 +7,9 @@
 - `Binary destination` can now point directly to an executable, used as-is; otherwise it is treated as a base directory
   as before
 - support for OAuth2
+- workspace listing now accepts a configurable `Workspace filter` (defaults to `owner:me`); leave it blank to include
+  workspaces shared with the current user
+- the URI handler accepts an optional `owner` query parameter to disambiguate shared workspaces
 
 ### Removed
 

src/main/kotlin/com/coder/toolbox/CoderRemoteEnvironment.kt

@@ -64,7 +64,8 @@ class CoderRemoteEnvironment(
         MutableStateFlow(environmentStatus.toRemoteEnvironmentState(context))
     override val description: MutableStateFlow<EnvironmentDescription> =
         MutableStateFlow(EnvironmentDescription.General(context.i18n.pnotr(workspace.templateDisplayName)))
-    override val additionalEnvironmentInformation: MutableMap<LocalizableString, String> = mutableMapOf()
+    override val additionalEnvironmentInformation: MutableMap<LocalizableString, String> =
+        mutableMapOf(context.i18n.ptrl("Owner") to workspace.ownerName)
     override val actionsList: MutableStateFlow<List<ActionDescription>> = MutableStateFlow(emptyList())
 
     private val networkMetricsMarshaller = Moshi.Builder().build().adapter(NetworkMetrics::class.java)

src/main/kotlin/com/coder/toolbox/sdk/CoderRestClient.kt

@@ -161,11 +161,19 @@ open class CoderRestClient(
     }
 
     /**
-     * Retrieves the available workspaces created by the user.
+     * Retrieves the available workspaces visible to the current user.
+     *
+     * The query string is taken from
+     * [com.coder.toolbox.settings.ReadOnlyCoderSettings.workspaceFilter], which
+     * defaults to `owner:me`. Users can broaden it (for example to an empty
+     * string) to also include workspaces shared with them.
+     *
      * @throws [APIResponseException].
      */
     suspend fun workspaces(): List<Workspace> {
-        val workspacesResponse = callWithRetry { retroRestClient.workspaces("owner:me") }
+        val workspacesResponse = callWithRetry {
+            retroRestClient.workspaces(context.settingsStore.workspaceFilter)
+        }
         if (!workspacesResponse.isSuccessful) {
             throw APIResponseException(
                 "retrieve workspaces",

src/main/kotlin/com/coder/toolbox/settings/ReadOnlyCoderSettings.kt

@@ -157,6 +157,13 @@ interface ReadOnlyCoderSettings {
      */
     val workspaceCreateUrl: String?
 
+    /**
+     * The filter applied when listing workspaces, passed to the server as the
+     * `q` query parameter. Defaults to `owner:me`. Set to an empty string to
+     * include workspaces shared with the current user.
+     */
+    val workspaceFilter: String
+
     /**
      * The path where network information for SSH hosts are stored
      */

src/main/kotlin/com/coder/toolbox/store/CoderSettingsStore.kt

@@ -88,6 +88,8 @@ class CoderSettingsStore(
         get() = store[WORKSPACE_VIEW_URL]
     override val workspaceCreateUrl: String?
         get() = store[WORKSPACE_CREATE_URL]
+    override val workspaceFilter: String
+        get() = store[WORKSPACE_FILTER] ?: "owner:me"
 
     /**
      * Where the specified deployment should put its data.
@@ -262,6 +264,10 @@ class CoderSettingsStore(
         store[PREFER_OAUTH2_IF_AVAILABLE] = preferAuthViaOAuth2.toString()
     }
 
+    fun updateWorkspaceFilter(filter: String) {
+        store[WORKSPACE_FILTER] = filter
+    }
+
     private fun getDefaultGlobalDataDir(): Path {
         return when (getOS()) {
             OS.WINDOWS -> Paths.get(getWinAppData(), "coder-toolbox")

src/main/kotlin/com/coder/toolbox/store/StoreKeys.kt

@@ -53,6 +53,7 @@ internal const val NETWORK_INFO_DIR = "networkInfoDir"
 
 internal const val WORKSPACE_VIEW_URL = "workspaceViewUrl"
 internal const val WORKSPACE_CREATE_URL = "workspaceCreateUrl"
+internal const val WORKSPACE_FILTER = "workspaceFilter"
 
 internal const val SSH_AUTO_CONNECT_PREFIX = "ssh_auto_connect_"
 

src/main/kotlin/com/coder/toolbox/util/CoderProtocolHandler.kt

@@ -46,7 +46,7 @@ open class CoderProtocolHandler(
         cli: CoderCLIManager
     ) {
         val workspaceName = resolveWorkspaceName(params) ?: return
-        val workspace = restClient.workspaces().matchName(workspaceName, url)
+        val workspace = restClient.workspaces().matchName(workspaceName, params.owner(), url)
         if (workspace != null) {
             if (!prepareWorkspace(workspace, restClient, cli, url)) return
             // we resolve the agent after the workspace is started otherwise we can get misleading
@@ -82,12 +82,22 @@ open class CoderProtocolHandler(
         return workspace
     }
 
-    private suspend fun List<Workspace>.matchName(workspaceName: String, deploymentURL: URL): Workspace? {
-        val workspace = this.firstOrNull { it.name == workspaceName }
+    private suspend fun List<Workspace>.matchName(
+        workspaceName: String,
+        owner: String?,
+        deploymentURL: URL,
+    ): Workspace? {
+        val candidates = this.filter { it.name == workspaceName }
+        val workspace = if (owner.isNullOrBlank()) {
+            candidates.firstOrNull()
+        } else {
+            candidates.firstOrNull { it.ownerName == owner }
+        }
         if (workspace == null) {
+            val descriptor = if (owner.isNullOrBlank()) workspaceName else "$owner/$workspaceName"
             context.logAndShowError(
                 CAN_T_HANDLE_URI_TITLE,
-                "There is no workspace with name $workspaceName on $deploymentURL"
+                "There is no workspace with name $descriptor on $deploymentURL"
             )
             return null
         }

src/main/kotlin/com/coder/toolbox/util/LinkMap.kt

@@ -3,6 +3,7 @@ package com.coder.toolbox.util
 const val URL = "url"
 const val TOKEN = "token"
 const val WORKSPACE = "workspace"
+const val OWNER = "owner"
 const val AGENT_NAME = "agent_name"
 private const val IDE_PRODUCT_CODE = "ide_product_code"
 private const val IDE_BUILD_NUMBER = "ide_build_number"
@@ -14,6 +15,8 @@ fun Map<String, String>.token() = this[TOKEN]
 
 fun Map<String, String>.workspace() = this[WORKSPACE]
 
+fun Map<String, String>.owner() = this[OWNER]
+
 fun Map<String, String?>.agentName() = this[AGENT_NAME]
 
 fun Map<String, String>.ideProductCode() = this[IDE_PRODUCT_CODE]

src/main/kotlin/com/coder/toolbox/views/CoderSettingsPage.kt

@@ -125,6 +125,12 @@ class CoderSettingsPage(
         TextType.General
     )
 
+    private val workspaceFilterField = TextField(
+        context.i18n.ptrl("Workspace filter (leave blank to include shared workspaces)"),
+        settings.workspaceFilter,
+        TextType.General,
+    )
+
     private lateinit var visibilityUpdateJob: Job
     override val fields: StateFlow<List<UiField>> = MutableStateFlow(
         listOf(
@@ -134,6 +140,7 @@ class CoderSettingsPage(
                 listOf(
                     useAppNameField,
                     disableAutostartField,
+                    workspaceFilterField,
                     httpLoggingField,
                 )
             ),
@@ -214,6 +221,7 @@ class CoderSettingsPage(
                     updateSshLogDir(sshLogDirField.contentState.value)
                     updateNetworkInfoDir(networkInfoDirField.contentState.value)
                     updateSshConfigOptions(sshExtraArgs.contentState.value)
+                    updateWorkspaceFilter(workspaceFilterField.contentState.value)
                 }
             }
         )
@@ -288,6 +296,10 @@ class CoderSettingsPage(
             settings.networkInfoDir
         }
 
+        workspaceFilterField.contentState.update {
+            settings.workspaceFilter
+        }
+
         visibilityUpdateJob = context.cs.launch(CoroutineName("Signature Verification Fallback Setting")) {
             disableSignatureVerificationField.checkedState.collect { state ->
                 signatureFallbackStrategyField.visibility.update {

src/test/kotlin/com/coder/toolbox/CoderRemoteProviderTest.kt

@@ -514,14 +514,16 @@ class CoderRemoteProviderTest {
     private fun mockWorkspace(
         name: String,
         status: WorkspaceStatus,
-        resources: List<WorkspaceResource>
+        resources: List<WorkspaceResource>,
+        ownerName: String = "owner",
     ): Workspace {
         val latestBuild = mockk<WorkspaceBuild> {
             every { this@mockk.status } returns status
             every { this@mockk.resources } returns resources
         }
         return mockk {
             every { this@mockk.name } returns name
+            every { this@mockk.ownerName } returns ownerName
             every { this@mockk.latestBuild } returns latestBuild
             every { this@mockk.templateDisplayName } returns name
             every { this@mockk.outdated } returns false