mirror of
https://github.com/coder/coder.git
synced 2026-11-03 05:55:24 +08:00
Ehab Younes
903d7b756d
Phase 2 of the Scalable Approach for Adding New IDE Session Types RFC, tracked in #27410. Adds a session_counts map to Stats on the Agent API, so an agent can report a count per app name instead of the four fixed fields, which are now marked deprecated. Bumps the API to v2.11. - coderd normalizes names on ingest, caps distinct entries, and sums the overflow under unknown, so an arbitrary client name cannot blow up cardinality. - Agents predating v2.11 set the fixed fields instead, never both, and the ingest path falls back to them. Nothing sends session_counts yet. The agent starts populating it in #28338.
108 lines
4.7 KiB
Go
108 lines
4.7 KiB
Go
package proto
|
|
|
|
import (
|
|
"context"
|
|
|
|
emptypb "google.golang.org/protobuf/types/known/emptypb"
|
|
"storj.io/drpc"
|
|
)
|
|
|
|
// DRPCAgentClient20 is the Agent API at v2.0. Notably, it is missing GetAnnouncementBanners, but
|
|
// is useful when you want to be maximally compatible with Coderd Release Versions from 2.9+
|
|
type DRPCAgentClient20 interface {
|
|
DRPCConn() drpc.Conn
|
|
|
|
GetManifest(ctx context.Context, in *GetManifestRequest) (*Manifest, error)
|
|
GetServiceBanner(ctx context.Context, in *GetServiceBannerRequest) (*ServiceBanner, error)
|
|
UpdateStats(ctx context.Context, in *UpdateStatsRequest) (*UpdateStatsResponse, error)
|
|
UpdateLifecycle(ctx context.Context, in *UpdateLifecycleRequest) (*Lifecycle, error)
|
|
BatchUpdateAppHealths(ctx context.Context, in *BatchUpdateAppHealthRequest) (*BatchUpdateAppHealthResponse, error)
|
|
UpdateStartup(ctx context.Context, in *UpdateStartupRequest) (*Startup, error)
|
|
BatchUpdateMetadata(ctx context.Context, in *BatchUpdateMetadataRequest) (*BatchUpdateMetadataResponse, error)
|
|
BatchCreateLogs(ctx context.Context, in *BatchCreateLogsRequest) (*BatchCreateLogsResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient21 is the Agent API at v2.1. It is useful if you want to be maximally compatible
|
|
// with Coderd Release Versions from 2.12+
|
|
type DRPCAgentClient21 interface {
|
|
DRPCAgentClient20
|
|
GetAnnouncementBanners(ctx context.Context, in *GetAnnouncementBannersRequest) (*GetAnnouncementBannersResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient22 is the Agent API at v2.2. It is identical to 2.1, since the change was made on
|
|
// the Tailnet API, which uses the same version number. Compatible with Coder v2.13+
|
|
type DRPCAgentClient22 interface {
|
|
DRPCAgentClient21
|
|
}
|
|
|
|
// DRPCAgentClient23 is the Agent API at v2.3. It adds the ScriptCompleted RPC. Compatible with
|
|
// Coder v2.18+
|
|
type DRPCAgentClient23 interface {
|
|
DRPCAgentClient22
|
|
ScriptCompleted(ctx context.Context, in *WorkspaceAgentScriptCompletedRequest) (*WorkspaceAgentScriptCompletedResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient24 is the Agent API at v2.4. It adds the GetResourcesMonitoringConfiguration,
|
|
// PushResourcesMonitoringUsage and ReportConnection RPCs. Compatible with Coder v2.19+
|
|
type DRPCAgentClient24 interface {
|
|
DRPCAgentClient23
|
|
GetResourcesMonitoringConfiguration(ctx context.Context, in *GetResourcesMonitoringConfigurationRequest) (*GetResourcesMonitoringConfigurationResponse, error)
|
|
PushResourcesMonitoringUsage(ctx context.Context, in *PushResourcesMonitoringUsageRequest) (*PushResourcesMonitoringUsageResponse, error)
|
|
ReportConnection(ctx context.Context, in *ReportConnectionRequest) (*emptypb.Empty, error)
|
|
}
|
|
|
|
// DRPCAgentClient25 is the Agent API at v2.5. It adds a ParentId field to the
|
|
// agent manifest response. Compatible with Coder v2.23+
|
|
type DRPCAgentClient25 interface {
|
|
DRPCAgentClient24
|
|
}
|
|
|
|
// DRPCAgentClient26 is the Agent API at v2.6. It adds the CreateSubAgent,
|
|
// DeleteSubAgent and ListSubAgents RPCs. Compatible with Coder v2.24+
|
|
type DRPCAgentClient26 interface {
|
|
DRPCAgentClient25
|
|
CreateSubAgent(ctx context.Context, in *CreateSubAgentRequest) (*CreateSubAgentResponse, error)
|
|
DeleteSubAgent(ctx context.Context, in *DeleteSubAgentRequest) (*DeleteSubAgentResponse, error)
|
|
ListSubAgents(ctx context.Context, in *ListSubAgentsRequest) (*ListSubAgentsResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient27 is the Agent API at v2.7. It adds the ReportBoundaryLogs
|
|
// RPC for forwarding boundary audit logs to coderd. Compatible with Coder v2.30+
|
|
type DRPCAgentClient27 interface {
|
|
DRPCAgentClient26
|
|
ReportBoundaryLogs(ctx context.Context, in *ReportBoundaryLogsRequest) (*ReportBoundaryLogsResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient28 is the Agent API at v2.8. It adds
|
|
// - a SubagentId field to the WorkspaceAgentDevcontainer message
|
|
// - an Id field to the CreateSubAgentRequest message.
|
|
// - UpdateAppStatus RPC.
|
|
//
|
|
// Compatible with Coder v2.31+
|
|
type DRPCAgentClient28 interface {
|
|
DRPCAgentClient27
|
|
UpdateAppStatus(ctx context.Context, in *UpdateAppStatusRequest) (*UpdateAppStatusResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient29 is the Agent API at v2.9. It adds
|
|
// session_id and confined_process fields to ReportBoundaryLogsRequest,
|
|
// and sequence_number to BoundaryLog. No new RPCs.
|
|
type DRPCAgentClient29 interface {
|
|
DRPCAgentClient28
|
|
}
|
|
|
|
// DRPCAgentClient210 is the Agent API at v2.10. It adds the
|
|
// PushContextState RPC used by the agent to ship resolved
|
|
// workspace context snapshots (instruction files, skills, MCP
|
|
// configs, MCP server tool lists) to coderd.
|
|
type DRPCAgentClient210 interface {
|
|
DRPCAgentClient29
|
|
PushContextState(ctx context.Context, in *PushContextStateRequest) (*PushContextStateResponse, error)
|
|
}
|
|
|
|
// DRPCAgentClient211 is the Agent API at v2.11. It adds the session_counts
|
|
// map to Stats. No new RPCs.
|
|
type DRPCAgentClient211 interface {
|
|
DRPCAgentClient210
|
|
}
|