feat: add Coder Ping Workspace command (#873)

Adds a `coder.pingWorkspace` command that runs `coder ping <workspace>`
locally and streams output to a custom PTY terminal, helping users
diagnose connection problems (latency, P2P diagnostics, DERP info).

Closes #749

Author: EhabY

package.json

@@ -259,6 +259,12 @@
 				"when": "!coder.authenticated && coder.loaded"
 			}
 		],
+		"submenus": [
+			{
+				"id": "coder.diagnostics",
+				"label": "Diagnostics"
+			}
+		],
 		"commands": [
 			{
 				"command": "coder.login",
@@ -368,6 +374,11 @@
 				"command": "coder.applyRecommendedSettings",
 				"title": "Apply Recommended SSH Settings",
 				"category": "Coder"
+			},
+			{
+				"command": "coder.pingWorkspace",
+				"title": "Ping Workspace",
+				"category": "Coder"
 			}
 		],
 		"menus": {
@@ -400,6 +411,10 @@
 					"command": "coder.navigateToWorkspaceSettings",
 					"when": "coder.workspace.connected"
 				},
+				{
+					"command": "coder.pingWorkspace",
+					"when": "coder.authenticated"
+				},
 				{
 					"command": "coder.workspace.update",
 					"when": "coder.workspace.updatable"
@@ -494,18 +509,28 @@
 			"view/item/context": [
 				{
 					"command": "coder.openFromSidebar",
-					"when": "coder.authenticated && viewItem == coderWorkspaceSingleAgent || coder.authenticated && viewItem == coderAgent",
+					"when": "coder.authenticated && viewItem =~ /^coderWorkspaceSingleAgent/ || coder.authenticated && viewItem =~ /^coderAgent/",
 					"group": "inline"
 				},
 				{
 					"command": "coder.navigateToWorkspace",
-					"when": "coder.authenticated && viewItem == coderWorkspaceSingleAgent || coder.authenticated && viewItem == coderWorkspaceMultipleAgents",
+					"when": "coder.authenticated && viewItem =~ /^coderWorkspaceSingleAgent/ || coder.authenticated && viewItem =~ /^coderWorkspaceMultipleAgents/",
 					"group": "inline"
 				},
 				{
 					"command": "coder.navigateToWorkspaceSettings",
-					"when": "coder.authenticated && viewItem == coderWorkspaceSingleAgent || coder.authenticated && viewItem == coderWorkspaceMultipleAgents",
+					"when": "coder.authenticated && viewItem =~ /^coderWorkspaceSingleAgent/ || coder.authenticated && viewItem =~ /^coderWorkspaceMultipleAgents/",
 					"group": "inline"
+				},
+				{
+					"submenu": "coder.diagnostics",
+					"when": "coder.authenticated && viewItem =~ /\\+running/",
+					"group": "navigation"
+				}
+			],
+			"coder.diagnostics": [
+				{
+					"command": "coder.pingWorkspace"
 				}
 			],
 			"statusBar/remoteIndicator": [

src/api/api-helper.ts

@@ -3,6 +3,7 @@ import {
 	type Workspace,
 	type WorkspaceAgent,
 	type WorkspaceResource,
+	type WorkspaceStatus,
 } from "coder/site/src/api/typesGenerated";
 import { ErrorEvent } from "eventsource";
 import { z } from "zod";
@@ -49,6 +50,26 @@ export function extractAgents(
 	}, [] as WorkspaceAgent[]);
 }
 
+const WORKSPACE_STATUS_LABEL: Readonly<Record<WorkspaceStatus, string>> = {
+	canceled: "Canceled",
+	canceling: "Canceling",
+	deleted: "Deleted",
+	deleting: "Deleting",
+	failed: "Failed",
+	pending: "Pending",
+	running: "Running",
+	starting: "Starting",
+	stopped: "Stopped",
+	stopping: "Stopping",
+};
+
+export function workspaceStatusLabel(status: WorkspaceStatus): string {
+	return (
+		WORKSPACE_STATUS_LABEL[status] ??
+		status.charAt(0).toUpperCase() + status.slice(1)
+	);
+}
+
 export const AgentMetadataEventSchema = z.object({
 	result: z.object({
 		collected_at: z.string(),