Jun 10, 2025 · Jun 10, 2025 · Jun 10, 2025 · Jun 10, 2025 · Jun 11, 2025 · Jun 11, 2025
diff --git a/agent/agentcontainers/api.go b/agent/agentcontainers/api.go
diff --git a/agent/agentcontainers/api_test.go b/agent/agentcontainers/api_test.go
diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
diff --git a/coderd/workspaceagents_test.go b/coderd/workspaceagents_test.go
 agentcontainers.DevcontainerConfigFileLabel:  configFile,
 }
 devContainer = codersdk.WorkspaceAgentContainer{
 ID:                 uuid.NewString(),
 CreatedAt:          dbtime.Now(),
 FriendlyName:       testutil.GetRandomName(t),
 Image:              "busybox:latest",
 Labels:             dcLabels,
 Running:            true,
 Status:             "running",
 DevcontainerDirty:  true,
 DevcontainerStatus: codersdk.WorkspaceAgentDevcontainerStatusRunning,
 ID:           uuid.NewString(),
 CreatedAt:    dbtime.Now(),
 FriendlyName: testutil.GetRandomName(t),
 Image:        "busybox:latest",
 Labels:       dcLabels,
 Running:      true,
 Status:       "running",
 }
 plainContainer = codersdk.WorkspaceAgentContainer{
 ID:           uuid.NewString(),
diff --git a/codersdk/workspaceagents.go b/codersdk/workspaceagents.go
 return listeningPorts, json.NewDecoder(res.Body).Decode(&listeningPorts)
 }

 // WorkspaceAgentDevcontainersResponse is the response to the devcontainers
 // request.
 type WorkspaceAgentDevcontainersResponse struct {
 Devcontainers []WorkspaceAgentDevcontainer `json:"devcontainers"`
 }

 // WorkspaceAgentDevcontainerStatus is the status of a devcontainer.
 type WorkspaceAgentDevcontainerStatus string

 Status    WorkspaceAgentDevcontainerStatus `json:"status"`
 Dirty     bool                             `json:"dirty"`
 Container *WorkspaceAgentContainer         `json:"container,omitempty"`
 Agent     *WorkspaceAgentDevcontainerAgent `json:"agent,omitempty"`
 }

 // WorkspaceAgentDevcontainerAgent represents the sub agent for a
 // devcontainer.
 type WorkspaceAgentDevcontainerAgent struct {
 ID        uuid.UUID `json:"id" format:"uuid"`
 Name      string    `json:"name"`
 Directory string    `json:"directory"`
 }

 // WorkspaceAgentContainer describes a devcontainer of some sort
 // Volumes is a map of "things" mounted into the container. Again, this
 // is somewhat implementation-dependent.
 Volumes map[string]string `json:"volumes"`
 // DevcontainerStatus is the status of the devcontainer, if this
 // container is a devcontainer. This is used to determine if the
 // devcontainer is running, stopped, starting, or in an error state.
 DevcontainerStatus WorkspaceAgentDevcontainerStatus `json:"devcontainer_status,omitempty"`
 // DevcontainerDirty is true if the devcontainer configuration has changed
 // since the container was created. This is used to determine if the
 // container needs to be rebuilt.
 DevcontainerDirty bool `json:"devcontainer_dirty"`
 }

 func (c *WorkspaceAgentContainer) Match(idOrName string) bool {
 // WorkspaceAgentListContainersResponse is the response to the list containers
 // request.
 type WorkspaceAgentListContainersResponse struct {
 // Devcontainers is a list of devcontainers visible to the workspace agent.
 Devcontainers []WorkspaceAgentDevcontainer `json:"devcontainers"`
 // Containers is a list of containers visible to the workspace agent.
 Containers []WorkspaceAgentContainer `json:"containers"`
 // Warnings is a list of warnings that may have occurred during the
diff --git a/docs/reference/api/agents.md b/docs/reference/api/agents.md
Original file line number	Diff line number	Diff line change
Expand Up		@@ -1403,15 +1403,13 @@ func TestWorkspaceAgentRecreateDevcontainer(t *testing.T) {
		agentcontainers.DevcontainerConfigFileLabel: configFile,
		}
		devContainer = codersdk.WorkspaceAgentContainer{
		ID: uuid.NewString(),
		CreatedAt: dbtime.Now(),
		FriendlyName: testutil.GetRandomName(t),
		Image: "busybox:latest",
		Labels: dcLabels,
		Running: true,
		Status: "running",
		DevcontainerDirty: true,
		DevcontainerStatus: codersdk.WorkspaceAgentDevcontainerStatusRunning,
		ID: uuid.NewString(),
		CreatedAt: dbtime.Now(),
		FriendlyName: testutil.GetRandomName(t),
		Image: "busybox:latest",
		Labels: dcLabels,
		Running: true,
		Status: "running",
		}
		plainContainer = codersdk.WorkspaceAgentContainer{
		ID: uuid.NewString(),
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -393,12 +393,6 @@ func (c *Client) WorkspaceAgentListeningPorts(ctx context.Context, agentID uuid.
		return listeningPorts, json.NewDecoder(res.Body).Decode(&listeningPorts)
		}

		// WorkspaceAgentDevcontainersResponse is the response to the devcontainers
		// request.
		type WorkspaceAgentDevcontainersResponse struct {
		Devcontainers []WorkspaceAgentDevcontainer `json:"devcontainers"`
		}

		// WorkspaceAgentDevcontainerStatus is the status of a devcontainer.
		type WorkspaceAgentDevcontainerStatus string

Expand All		@@ -422,6 +416,15 @@ type WorkspaceAgentDevcontainer struct {
		Status WorkspaceAgentDevcontainerStatus `json:"status"`
		Dirty bool `json:"dirty"`
		Container *WorkspaceAgentContainer `json:"container,omitempty"`
		Agent *WorkspaceAgentDevcontainerAgent `json:"agent,omitempty"`
		}

		// WorkspaceAgentDevcontainerAgent represents the sub agent for a
		// devcontainer.
		type WorkspaceAgentDevcontainerAgent struct {
		ID uuid.UUID `json:"id" format:"uuid"`
		Name string `json:"name"`
		Directory string `json:"directory"`
		}

		// WorkspaceAgentContainer describes a devcontainer of some sort
Expand DownExpand Up		@@ -450,14 +453,6 @@ type WorkspaceAgentContainer struct {
		// Volumes is a map of "things" mounted into the container. Again, this
		// is somewhat implementation-dependent.
		Volumes map[string]string `json:"volumes"`
		// DevcontainerStatus is the status of the devcontainer, if this
		// container is a devcontainer. This is used to determine if the
		// devcontainer is running, stopped, starting, or in an error state.
		DevcontainerStatus WorkspaceAgentDevcontainerStatus `json:"devcontainer_status,omitempty"`
		// DevcontainerDirty is true if the devcontainer configuration has changed
		// since the container was created. This is used to determine if the
		// container needs to be rebuilt.
		DevcontainerDirty bool `json:"devcontainer_dirty"`
		}

		func (c *WorkspaceAgentContainer) Match(idOrName string) bool {
Expand DownExpand Up		@@ -486,6 +481,8 @@ type WorkspaceAgentContainerPort struct {
		// WorkspaceAgentListContainersResponse is the response to the list containers
		// request.
		type WorkspaceAgentListContainersResponse struct {
		// Devcontainers is a list of devcontainers visible to the workspace agent.
		Devcontainers []WorkspaceAgentDevcontainer `json:"devcontainers"`
		// Containers is a list of containers visible to the workspace agent.
		Containers []WorkspaceAgentContainer `json:"containers"`
		// Warnings is a list of warnings that may have occurred during the
Expand Down