workspace.proto

Generated from proto/blitz/v1/workspace.proto by proto-gen-md-diagrams.

classDiagram
direction LR
%% Mermaid Diagram for package: blitz.v1

%% Saved reports where a change was written in the config file. The change applies even when saving fails.

class Saved {
  + string path
  + string error
}

%% Request message for WorkspaceService.Shutdown.

class ShutdownRequest {
}

%% Response message for WorkspaceService.Shutdown: sent before the service stops.

class ShutdownResponse {
}

%% Request message for WorkspaceService.GetServiceInfo.

class GetServiceInfoRequest {
}

%% Response message for WorkspaceService.GetServiceInfo.

class GetServiceInfoResponse {
  + string version
  + string executable
  + google.protobuf.Timestamp started
  + int32 pid
  + bool replaced
}

%% Request message for WorkspaceService.ListLogDays.

class ListLogDaysRequest {
}

%% Response message for WorkspaceService.ListLogDays.

class ListLogDaysResponse {
  + List~string~ days
  + string dir
}

%% Request message for WorkspaceService.ReadLog.

class ReadLogRequest {
  + string day
  + string min_level
  + string text
  + int32 limit
}

%% A field of a log record.

class LogAttr {
  + string key
  + string value
}

%% A log record.

class LogEntry {
  + google.protobuf.Timestamp time
  + string level
  + string message
  + List~LogAttr~ attrs
}
LogEntry --> `LogAttr`

%% Response message for WorkspaceService.ReadLog.

class ReadLogResponse {
  + string day
  + string path
  + List~LogEntry~ entries
  + int32 matched
}
ReadLogResponse --> `LogEntry`

%% Request message for WorkspaceService.DeleteLogDay.

class DeleteLogDayRequest {
  + string day
}

%% Response message for WorkspaceService.DeleteLogDay.

class DeleteLogDayResponse {
}

%% Request message for WorkspaceService.ListWorkspaces.

class ListWorkspacesRequest {
}

%% Response message for WorkspaceService.ListWorkspaces.

class ListWorkspacesResponse {
  + List~string~ workspaces
}

%% Request message for WorkspaceService.CloseWorkspace.

class CloseWorkspaceRequest {
  + string workspace
}

%% Response message for WorkspaceService.CloseWorkspace.

class CloseWorkspaceResponse {
}

%% Request message for WorkspaceService.GetSandbox.

class GetSandboxRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetSandbox.

class GetSandboxResponse {
  + List~string~ summary
}

%% AgentInfo describes an agent.

class AgentInfo {
  + string name
  + string display_name
  + string description
  + bool active
  + string pinned_model
}

%% Request message for WorkspaceService.ListAgents.

class ListAgentsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListAgents.

class ListAgentsResponse {
  + List~AgentInfo~ agents
}
ListAgentsResponse --> `AgentInfo`

%% Request message for WorkspaceService.SetAgent.

class SetAgentRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.SetAgent.

class SetAgentResponse {
  + AgentInfo agent
}
SetAgentResponse --> `AgentInfo`

%% Suggestion is one welcome tile.

class Suggestion {
  + SuggestionKind kind
  + string title
  + string prompt
  + string session_id
  + string worker
  + int32 count
  + string detail
}
Suggestion --> `SuggestionKind`

%% Request message for WorkspaceService.GetSuggestions.

class GetSuggestionsRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetSuggestions.

class GetSuggestionsResponse {
  + List~Suggestion~ suggestions
  + bool harness_missing
  + bool pending
}
GetSuggestionsResponse --> `Suggestion`

%% AgentDefinition is an agent's file: its frontmatter and its prompt.

class AgentDefinition {
  + string name
  + string display_name
  + string description
  + List~string~ tools
  + string default_model
  + string agency_level
  + string permission_mode
  + int32 max_turns
  + bool background
  + string isolation
  + Optional~double~ temperature
  + Optional~double~ top_p
  + Optional~int32~ max_tokens
  + string effort
  + Optional~int32~ thinking_budget
  + string prompt
}

%% AgentFile is one agent file of a scope.

class AgentFile {
  + string path
  + AgentDefinition agent
  + string problem
}
AgentFile --> `AgentDefinition`

%% Request message for WorkspaceService.ListAgentFiles.

class ListAgentFilesRequest {
  + string workspace
  + AgentScope scope
}
ListAgentFilesRequest --> `AgentScope`

%% Response message for WorkspaceService.ListAgentFiles.

class ListAgentFilesResponse {
  + List~AgentFile~ files
  + string dir
}
ListAgentFilesResponse --> `AgentFile`

%% Request message for WorkspaceService.SaveAgentFile.

class SaveAgentFileRequest {
  + string workspace
  + AgentScope scope
  + string previous_name
  + AgentDefinition agent
}
SaveAgentFileRequest --> `AgentScope`
SaveAgentFileRequest --> `AgentDefinition`

%% Response message for WorkspaceService.SaveAgentFile.

class SaveAgentFileResponse {
  + AgentFile file
  + List~string~ problems
}
SaveAgentFileResponse --> `AgentFile`

%% Request message for WorkspaceService.DeleteAgentFile.

class DeleteAgentFileRequest {
  + string workspace
  + AgentScope scope
  + string name
  + string path
}
DeleteAgentFileRequest --> `AgentScope`

%% Response message for WorkspaceService.DeleteAgentFile.

class DeleteAgentFileResponse {
}

%% Request message for WorkspaceService.GetModel.

class GetModelRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetModel.

class GetModelResponse {
  + string name
  + string provider
  + string unavailable
}

%% Request message for WorkspaceService.SetModel.

class SetModelRequest {
  + string workspace
  + string ref
}

%% Response message for WorkspaceService.SetModel.

class SetModelResponse {
  + string active_pin
}

%% Request message for WorkspaceService.PinModel.

class PinModelRequest {
  + string workspace
  + string agent
  + string ref
}

%% Response message for WorkspaceService.PinModel.

class PinModelResponse {
  + string agent
  + string model
  + Saved saved
}
PinModelResponse --> `Saved`

%% Request message for WorkspaceService.UnpinModel.

class UnpinModelRequest {
  + string workspace
  + string agent
}

%% Response message for WorkspaceService.UnpinModel.

class UnpinModelResponse {
  + string agent
  + string model
  + Saved saved
}
UnpinModelResponse --> `Saved`

%% ModelSettings are a model's generation settings; unset fields use the global value or the provider's default.

class ModelSettings {
  + Optional~double~ temperature
  + Optional~int32~ max_tokens
  + Optional~double~ top_p
  + Optional~int32~ seed
  + Optional~string~ reasoning_effort
  + Optional~int32~ thinking_budget
}

%% ModelSettingsInfo is one model's settings and what applies otherwise.

class ModelSettingsInfo {
  + string model
  + string provider
  + ModelSettings settings
  + double global_temperature
  + int32 global_max_tokens
}
ModelSettingsInfo --> `ModelSettings`

%% Request message for WorkspaceService.GetModelSettings.

class GetModelSettingsRequest {
  + string workspace
  + string ref
}

%% Response message for WorkspaceService.GetModelSettings.

class GetModelSettingsResponse {
  + Map~string,  ModelSettings~ all
  + ModelSettingsInfo model
}
GetModelSettingsResponse .. ` ModelSettings`
GetModelSettingsResponse --> `ModelSettingsInfo`

%% Setting is one key=value change; an empty value clears the key.

class Setting {
  + string key
  + string value
}

%% Request message for WorkspaceService.UpdateModelSettings.

class UpdateModelSettingsRequest {
  + string workspace
  + string ref
  + bool reset
  + List~Setting~ changes
}
UpdateModelSettingsRequest --> `Setting`

%% Response message for WorkspaceService.UpdateModelSettings.

class UpdateModelSettingsResponse {
  + ModelSettingsInfo model
  + List~string~ unsupported
  + Saved saved
}
UpdateModelSettingsResponse --> `ModelSettingsInfo`
UpdateModelSettingsResponse --> `Saved`

%% Request message for WorkspaceService.GetSettings.

class GetSettingsRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetSettings.

class GetSettingsResponse {
  + string agency
  + string model
  + string provider
  + string agent
  + string locale
  + bool images_enabled
  + string permission_mode
  + string effort
  + string style
  + string speech_model
  + string speech_error
  + List~AcceptedMedia~ accepted_media
}
GetSettingsResponse --> `AcceptedMedia`

%% AcceptedMedia is a kind of attachment a model takes.

class AcceptedMedia {
  + string kind
  + List~string~ mime_types
  + List~string~ extensions
  + int64 max_bytes
}

%% Request message for WorkspaceService.SetPermissionMode.

class SetPermissionModeRequest {
  + string workspace
  + string mode
}

%% Response message for WorkspaceService.SetPermissionMode.

class SetPermissionModeResponse {
  + string mode
}

%% Command is a custom slash command.

class Command {
  + string name
  + string description
  + string argument_hint
  + string source
}

%% Request message for WorkspaceService.ListCommands.

class ListCommandsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListCommands.

class ListCommandsResponse {
  + List~Command~ commands
}
ListCommandsResponse --> `Command`

%% PermissionRule is an allow, ask or deny rule.

class PermissionRule {
  + string effect
  + string rule
  + string source
}

%% Request message for WorkspaceService.ListPermissionRules.

class ListPermissionRulesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListPermissionRules.

class ListPermissionRulesResponse {
  + List~PermissionRule~ rules
  + string problem
}
ListPermissionRulesResponse --> `PermissionRule`

%% Request message for WorkspaceService.AddPermissionRule.

class AddPermissionRuleRequest {
  + string workspace
  + string effect
  + string rule
  + bool save
  + string scope
}

%% Response message for WorkspaceService.AddPermissionRule.

class AddPermissionRuleResponse {
  + string rule
  + bool next_start
  + Saved saved
}
AddPermissionRuleResponse --> `Saved`

%% Request message for WorkspaceService.RemovePermissionRule.

class RemovePermissionRuleRequest {
  + string workspace
  + string rule
  + bool save
  + string scope
}

%% Response message for WorkspaceService.RemovePermissionRule.

class RemovePermissionRuleResponse {
  + string rule
  + int32 removed
  + Saved saved
}
RemovePermissionRuleResponse --> `Saved`

%% Request message for WorkspaceService.SetSetting.

class SetSettingRequest {
  + string workspace
  + string key
  + string value
}

%% Response message for WorkspaceService.SetSetting.

class SetSettingResponse {
  + string key
}

%% SkillInfo describes a skill and what the skills policy lets it do.

class SkillInfo {
  + string name
  + string description
  + string version
  + string license
  + string category
  + string compatibility
  + List~string~ tags
  + string hash
  + List~SkillTool~ tools
  + List~SkillScript~ scripts
  + string tier
  + bool bypass
  + bool network
  + bool needs_network
  + List~string~ env
  + List~string~ withheld
  + List~string~ blocked
  + string dir
  + string kind
  + List~string~ agents
  + List~string~ members
  + List~string~ references
  + bool project
  + List~string~ package_files
  + bool needs_review
}
SkillInfo --> `SkillTool`
SkillInfo --> `SkillScript`

%% SkillTool is a tool a skill needs.

class SkillTool {
  + string name
  + List~string~ scopes
  + string why
}

%% SkillScript is one of a skill's scripts and the policy's verdict.

class SkillScript {
  + string name
  + string language
  + string source
  + google.protobuf.Duration timeout
  + List~string~ deps
  + bool allowed
  + List~string~ reasons
  + bool found
}

%% Request message for WorkspaceService.ListSkills.

class ListSkillsRequest {
  + string workspace
  + string query
}

%% Response message for WorkspaceService.ListSkills.

class ListSkillsResponse {
  + List~SkillInfo~ skills
}
ListSkillsResponse --> `SkillInfo`

%% Request message for WorkspaceService.GetSkill.

class GetSkillRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.GetSkill.

class GetSkillResponse {
  + SkillInfo skill
}
GetSkillResponse --> `SkillInfo`

%% What Studio's skill form edits.

class SkillSpec {
  + string name
  + string description
  + string tools
  + List~string~ agents
  + List~string~ members
  + string instructions
}

%% A skill as Studio edits it.

class SkillFile {
  + SkillInfo skill
  + string path
  + string hash
  + SkillSpec spec
  + bool editable
}
SkillFile --> `SkillInfo`
SkillFile --> `SkillSpec`

%% Request message for WorkspaceService.GetSkillFile.

class GetSkillFileRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.GetSkillFile.

class GetSkillFileResponse {
  + SkillFile file
}
GetSkillFileResponse --> `SkillFile`

%% Request message for WorkspaceService.SaveSkill.

class SaveSkillRequest {
  + string workspace
  + string previous_name
  + string hash
  + SkillSpec skill
}
SaveSkillRequest --> `SkillSpec`

%% Response message for WorkspaceService.SaveSkill.

class SaveSkillResponse {
  + SkillFile file
  + List~string~ problems
}
SaveSkillResponse --> `SkillFile`

%% Request message for WorkspaceService.DeleteSkill.

class DeleteSkillRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.DeleteSkill.

class DeleteSkillResponse {
}

%% Request message for WorkspaceService.ReadSkillFile.

class ReadSkillFileRequest {
  + string workspace
  + string name
  + string path
}

%% Response message for WorkspaceService.ReadSkillFile.

class ReadSkillFileResponse {
  + bytes content
}

%% Request message for WorkspaceService.WriteSkillFile.

class WriteSkillFileRequest {
  + string workspace
  + string name
  + string path
  + bytes content
}

%% Response message for WorkspaceService.WriteSkillFile.

class WriteSkillFileResponse {
  + SkillFile file
}
WriteSkillFileResponse --> `SkillFile`

%% Request message for WorkspaceService.DeleteSkillFile.

class DeleteSkillFileRequest {
  + string workspace
  + string name
  + string path
}

%% Response message for WorkspaceService.DeleteSkillFile.

class DeleteSkillFileResponse {
  + SkillFile file
}
DeleteSkillFileResponse --> `SkillFile`

%% Request message for WorkspaceService.CopySkill.

class CopySkillRequest {
  + string workspace
  + string from
  + string name
}

%% Response message for WorkspaceService.CopySkill.

class CopySkillResponse {
  + SkillFile file
  + List~string~ problems
}
CopySkillResponse --> `SkillFile`

%% Request message for WorkspaceService.RunSkillScript.

class RunSkillScriptRequest {
  + string workspace
  + string name
  + string script
  + List~string~ args
}

%% Response message for WorkspaceService.RunSkillScript.

class RunSkillScriptResponse {
  + int32 exit_code
  + string stdout
  + string stderr
  + bool timed_out
  + string sandbox
  + List~string~ output_files
  + string error
}

%% Env is an isolated Python environment built for skill scripts.

class Env {
  + string key
  + List~string~ deps
  + List~string~ skills
  + int64 size
  + google.protobuf.Timestamp last_used
  + bool ready
}

%% Request message for WorkspaceService.ListEnvs.

class ListEnvsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListEnvs.

class ListEnvsResponse {
  + List~Env~ envs
}
ListEnvsResponse --> `Env`

%% Request message for WorkspaceService.RemoveEnv.

class RemoveEnvRequest {
  + string workspace
  + string key
}

%% Response message for WorkspaceService.RemoveEnv.

class RemoveEnvResponse {
}

%% Request message for WorkspaceService.PruneEnvs.

class PruneEnvsRequest {
  + string workspace
}

%% EnvError is an environment that couldn't be removed.

class EnvError {
  + string key
  + string error
}

%% Response message for WorkspaceService.PruneEnvs.

class PruneEnvsResponse {
  + int32 removed
  + int64 freed
  + List~EnvError~ failed
}
PruneEnvsResponse --> `EnvError`

%% MCPServer is a configured MCP server.

class MCPServer {
  + string name
  + string target
  + bool auto_approve
  + bool disabled
  + string state
  + string error
  + int32 tools
}

%% Request message for WorkspaceService.ListMCPServers.

class ListMCPServersRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListMCPServers.

class ListMCPServersResponse {
  + List~MCPServer~ servers
}
ListMCPServersResponse --> `MCPServer`

%% Request message for WorkspaceService.RestartMCPServer.

class RestartMCPServerRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.RestartMCPServer.

class RestartMCPServerResponse {
}

%% ToolInfo is a tool an agent can call.

class ToolInfo {
  + string name
  + string description
  + bool plan_allowed
}

%% MCPOffer is an MCP server offered to an agent.

class MCPOffer {
  + string server
  + List~string~ tools
  + string prefix
}

%% Request message for WorkspaceService.ListTools.

class ListToolsRequest {
  + string workspace
  + bool all
}

%% Response message for WorkspaceService.ListTools.

class ListToolsResponse {
  + string agent
  + List~ToolInfo~ tools
  + List~MCPOffer~ mcp
}
ListToolsResponse --> `ToolInfo`
ListToolsResponse --> `MCPOffer`

%% Request message for WorkspaceService.ReloadMemory.

class ReloadMemoryRequest {
  + string workspace
}

%% Response message for WorkspaceService.ReloadMemory.

class ReloadMemoryResponse {
  + List~string~ paths
  + List~string~ files
}

%% Request message for WorkspaceService.ReloadAgentFiles.

class ReloadAgentFilesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ReloadAgentFiles.

class ReloadAgentFilesResponse {
  + int32 agents
  + int32 skills
  + List~string~ files
  + List~string~ problems
}

%% Request message for WorkspaceService.AddMemory.

class AddMemoryRequest {
  + string workspace
  + string text
}

%% Response message for WorkspaceService.AddMemory.

class AddMemoryResponse {
  + string path
}

%% LocaleInfo names a language with an interface catalog.

class LocaleInfo {
  + string tag
  + string name
}

%% Request message for WorkspaceService.ListLocales.

class ListLocalesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListLocales.

class ListLocalesResponse {
  + List~LocaleInfo~ locales
  + string custom_dir
}
ListLocalesResponse --> `LocaleInfo`

%% Request message for WorkspaceService.SetLocale.

class SetLocaleRequest {
  + string workspace
  + string input
}

%% Response message for WorkspaceService.SetLocale.

class SetLocaleResponse {
  + string tag
  + string native_name
  + string language_name
  + bool has_catalog
  + Saved saved
}
SetLocaleResponse --> `Saved`

%% Checkpoint is the files one turn changed.

class Checkpoint {
  + int32 id
  + string label
  + google.protobuf.Timestamp time
  + List~string~ files
}

%% Request message for WorkspaceService.ListCheckpoints.

class ListCheckpointsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListCheckpoints.

class ListCheckpointsResponse {
  + List~Checkpoint~ checkpoints
}
ListCheckpointsResponse --> `Checkpoint`

%% Request message for WorkspaceService.Undo.

class UndoRequest {
  + string workspace
  + bool force
}

%% Response message for WorkspaceService.Undo.

class UndoResponse {
  + string label
  + List~string~ restored
  + ErrorInfo error
}
UndoResponse --> `ErrorInfo`

%% Request message for WorkspaceService.GetDiff.

class GetDiffRequest {
  + string workspace
  + bool git
  + bool color
}

%% Response message for WorkspaceService.GetDiff.

class GetDiffResponse {
  + string diff
}

%% Approval is a standing permission.

class Approval {
  + string key
  + string kind
  + string subject
  + string dir
  + bool always
  + google.protobuf.Timestamp added
}

%% Request message for WorkspaceService.ListApprovals.

class ListApprovalsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListApprovals.

class ListApprovalsResponse {
  + List~Approval~ approvals
}
ListApprovalsResponse --> `Approval`

%% Request message for WorkspaceService.RevokeApprovals.

class RevokeApprovalsRequest {
  + string workspace
  + List~string~ keys
  + bool all
}

%% Response message for WorkspaceService.RevokeApprovals.

class RevokeApprovalsResponse {
  + int32 revoked
  + ErrorInfo error
}
RevokeApprovalsResponse --> `ErrorInfo`

%% Process is a background process the agent started, and how it is.

class Process {
  + int32 id
  + string command
  + bool running
  + int32 exit_code
  + int64 runtime_ms
}

%% Request message for WorkspaceService.ListProcesses.

class ListProcessesRequest {
  + string workspace
  + List~string~ session_ids
}

%% Response message for WorkspaceService.ListProcesses.

class ListProcessesResponse {
  + List~Process~ processes
}
ListProcessesResponse --> `Process`

%% Request message for WorkspaceService.GetProcessOutput.

class GetProcessOutputRequest {
  + string workspace
  + List~string~ session_ids
  + int32 id
}

%% Response message for WorkspaceService.GetProcessOutput.

class GetProcessOutputResponse {
  + string output
  + Process process
}
GetProcessOutputResponse --> `Process`

%% Request message for WorkspaceService.KillProcess.

class KillProcessRequest {
  + string workspace
  + List~string~ session_ids
  + int32 id
}

%% Response message for WorkspaceService.KillProcess.

class KillProcessResponse {
  + Process process
}
KillProcessResponse --> `Process`

%% Request message for WorkspaceService.AuditShell.

class AuditShellRequest {
  + string workspace
  + string command
  + int32 exit_code
  + string start_error
}

%% Response message for WorkspaceService.AuditShell.

class AuditShellResponse {
}

%% BackgroundTask is a sub-agent running beside the turn that started it.

class BackgroundTask {
  + string id
  + string agent
  + string prompt
  + string session_id
  + string state
  + google.protobuf.Timestamp started
  + google.protobuf.Timestamp ended
  + string result
  + string error
  + Usage usage
  + string worktree
  + string branch
}
BackgroundTask --> `Usage`

%% Request message for WorkspaceService.ListTasks.

class ListTasksRequest {
  + string workspace
  + List~string~ session_ids
}

%% Response message for WorkspaceService.ListTasks.

class ListTasksResponse {
  + List~BackgroundTask~ tasks
}
ListTasksResponse --> `BackgroundTask`

%% Request message for WorkspaceService.GetTask.

class GetTaskRequest {
  + string workspace
  + List~string~ session_ids
  + string id
}

%% Response message for WorkspaceService.GetTask.

class GetTaskResponse {
  + BackgroundTask task
  + List~string~ events
}
GetTaskResponse --> `BackgroundTask`

%% Request message for WorkspaceService.StopTask.

class StopTaskRequest {
  + string workspace
  + List~string~ session_ids
  + string id
}

%% TaskEvent is something that happened to a background task outside a turn.

class TaskEvent {
  + Oneof~BackgroundTask~ task [oneof: kind]
  + Oneof~ApprovalRequest~ approval_request [oneof: kind]
  + Oneof~Question~ question [oneof: kind]
  + Oneof~string~ resolved [oneof: kind]
  + Oneof~bool~ ready [oneof: kind]
  + Oneof~bool~ settings_changed [oneof: kind]
}
TaskEvent --> `BackgroundTask`
TaskEvent --> `ApprovalRequest`
TaskEvent --> `Question`

%% Request message for WorkspaceService.WatchTasks.

class WatchTasksRequest {
  + string workspace
  + List~string~ session_ids
}

%% Response message for WorkspaceService.WatchTasks.

class WatchTasksResponse {
  + TaskEvent event
}
WatchTasksResponse --> `TaskEvent`

%% Request message for WorkspaceService.ListTaskRequests.

class ListTaskRequestsRequest {
  + string workspace
  + List~string~ session_ids
}

%% Response message for WorkspaceService.ListTaskRequests.

class ListTaskRequestsResponse {
  + List~TaskEvent~ requests
}
ListTaskRequestsResponse --> `TaskEvent`

%% Response message for WorkspaceService.StopTask.

class StopTaskResponse {
  + BackgroundTask task
}
StopTaskResponse --> `BackgroundTask`

%% ProjectItem is one setting from a project file.

class ProjectItem {
  + string file
  + string kind
  + string key
  + string value
  + string reason
}

%% ProjectSettings are what a workspace's project files say.

class ProjectSettings {
  + List~string~ files
  + string state
  + string hash
  + bool loaded
  + List~ProjectItem~ applied
  + List~ProjectItem~ pending
  + List~ProjectItem~ ignored
  + List~string~ problems
}
ProjectSettings --> `ProjectItem`
ProjectSettings --> `ProjectItem`
ProjectSettings --> `ProjectItem`

%% Request message for WorkspaceService.GetProjectSettings.

class GetProjectSettingsRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetProjectSettings.

class GetProjectSettingsResponse {
  + ProjectSettings settings
}
GetProjectSettingsResponse --> `ProjectSettings`

%% Request message for WorkspaceService.TakeProcessNotices.

class TakeProcessNoticesRequest {
  + string workspace
  + string session_id
}

%% Response message for WorkspaceService.TakeProcessNotices.

class TakeProcessNoticesResponse {
  + List~string~ notices
}

%% Style is an output style.

class Style {
  + string name
  + string description
  + string source
  + bool active
}

%% Request message for WorkspaceService.ListStyles.

class ListStylesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListStyles.

class ListStylesResponse {
  + List~Style~ styles
}
ListStylesResponse --> `Style`

%% Hook is a configured hook.

class Hook {
  + string event
  + string type
  + string match
  + string if
  + string runs
  + string source
  + bool fail_closed
  + List~HookFailure~ failures
}
Hook --> `HookFailure`

%% HookFailure is one failed run of a hook.

class HookFailure {
  + google.protobuf.Timestamp time
  + string error
}

%% Request message for WorkspaceService.ListHooks.

class ListHooksRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListHooks.

class ListHooksResponse {
  + List~Hook~ hooks
}
ListHooksResponse --> `Hook`

%% Note is something the agent remembered across sessions of a workspace.

class Note {
  + string name
  + string kind
  + string text
  + google.protobuf.Timestamp time
  + string path
}

%% Request message for WorkspaceService.ListNotes.

class ListNotesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListNotes.

class ListNotesResponse {
  + List~Note~ notes
}
ListNotesResponse --> `Note`

%% Request message for WorkspaceService.ForgetNote.

class ForgetNoteRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.ForgetNote.

class ForgetNoteResponse {
}

%% Request message for WorkspaceService.ForgetProjectTrust.

class ForgetProjectTrustRequest {
  + string workspace
}

%% Response message for WorkspaceService.ForgetProjectTrust.

class ForgetProjectTrustResponse {
  + bool reopened
}

%% Request message for WorkspaceService.TrustProject.

class TrustProjectRequest {
  + string workspace
  + string hash
  + bool trusted
}

%% Response message for WorkspaceService.TrustProject.

class TrustProjectResponse {
  + bool reopened
}

%% Image is an image or a PDF stored for a prompt.

class Image {
  + string id
  + string name
  + string mime_type
  + int32 width
  + int32 height
  + int64 size
  + bool resized
  + int32 pages
  + string kind
  + double seconds
}

%% Request message for WorkspaceService.LoadImage.

class LoadImageRequest {
  + string workspace
  + string path
}

%% Response message for WorkspaceService.LoadImage.

class LoadImageResponse {
  + Image image
}
LoadImageResponse --> `Image`

%% Request message for WorkspaceService.AddImage.

class AddImageRequest {
  + string workspace
  + string name
  + bytes data
}

%% Response message for WorkspaceService.AddImage.

class AddImageResponse {
  + Image image
}
AddImageResponse --> `Image`

%% Link is a search result handed to the agent.

class Link {
  + string title
  + string url
}

%% Request message for WorkspaceService.GetSearchProvider.

class GetSearchProviderRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetSearchProvider.

class GetSearchProviderResponse {
  + string provider
}

%% Request message for WorkspaceService.SearchWeb.

class SearchWebRequest {
  + string workspace
  + string terms
}

%% Response message for WorkspaceService.SearchWeb.

class SearchWebResponse {
  + string provider
  + List~Link~ links
  + string prompt
}
SearchWebResponse --> `Link`

%% Request message for WorkspaceService.SearchWorkspace.

class SearchWorkspaceRequest {
  + string workspace
  + string query
  + List~string~ sources
  + int32 limit
  + string mode
  + bool hidden
}

%% SearchHit is one item workspace search found.

class SearchHit {
  + string source
  + string ref
  + string title
  + int32 line
  + string section
  + string snippet
  + double score
  + string summary
  + List~string~ tags
}

%% Response message for WorkspaceService.SearchWorkspace.

class SearchWorkspaceResponse {
  + List~SearchHit~ hits
  + List~string~ sources
}
SearchWorkspaceResponse --> `SearchHit`

%% Request message for WorkspaceService.GetSearchStatus.

class GetSearchStatusRequest {
  + string workspace
}

%% SearchStatus is how a workspace's search index is.

class SearchStatus {
  + bool enabled
  + Map~string,  int32~ items
  + bool scanning
  + google.protobuf.Timestamp last_scan
  + int32 unreadable
  + string error
  + string embedding_model
  + int32 embedded
  + string embed_error
  + int32 enriched
  + string enrich_error
  + SearchSettings settings
  + string problem
}
SearchStatus --> `SearchSettings`

%% SearchSettings are a workspace's [search] settings (set with ConfigService.SetConfigValue: search.enabled, search.sources, …).

class SearchSettings {
  + bool enabled
  + List~string~ sources
  + string embedding_model
  + bool enrich
  + string enrich_model
  + int32 enrich_daily_limit
  + bool include_ignored
}

%% Response message for WorkspaceService.GetSearchStatus.

class GetSearchStatusResponse {
  + SearchStatus status
}
GetSearchStatusResponse --> `SearchStatus`

%% Request message for WorkspaceService.Reindex.

class ReindexRequest {
  + string workspace
}

%% Response message for WorkspaceService.Reindex.

class ReindexResponse {
}

%% Request message for WorkspaceService.GetGitStatus.

class GetGitStatusRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetGitStatus.

class GetGitStatusResponse {
  + bool repo
  + string branch
  + int32 changed
  + bool git
  + bool remote
  + string upstream
  + int32 ahead
  + int32 behind
  + GitOperation operation
  + List~string~ conflicts
  + string merging
}
GetGitStatusResponse --> `GitOperation`

%% Request message for WorkspaceService.InitGitRepo.

class InitGitRepoRequest {
  + string workspace
}

%% Response message for WorkspaceService.InitGitRepo.

class InitGitRepoResponse {
  + GetGitStatusResponse status
}
InitGitRepoResponse --> `GetGitStatusResponse`

%% A file in the index, for the commit dialog.

class StagedFile {
  + string status
  + string path
}

%% Request message for WorkspaceService.DraftCommit.

class DraftCommitRequest {
  + string workspace
  + bool stage_all
}

%% Response message for WorkspaceService.DraftCommit.

class DraftCommitResponse {
  + List~StagedFile~ files
  + string message
  + string problem
}
DraftCommitResponse --> `StagedFile`

%% Request message for WorkspaceService.Commit.

class CommitRequest {
  + string workspace
  + string message
}

%% Response message for WorkspaceService.Commit.

class CommitResponse {
  + string hash
  + string subject
}

%% Request message for WorkspaceService.FetchRemote.

class FetchRemoteRequest {
  + string workspace
}

%% Response message for WorkspaceService.FetchRemote.

class FetchRemoteResponse {
  + GetGitStatusResponse status
}
FetchRemoteResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.Pull.

class PullRequest {
  + string workspace
}

%% Response message for WorkspaceService.Pull.

class PullResponse {
  + PullOutcome outcome
  + int32 commits
  + GetGitStatusResponse status
}
PullResponse --> `PullOutcome`
PullResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.Push.

class PushRequest {
  + string workspace
}

%% Response message for WorkspaceService.Push.

class PushResponse {
  + string target
  + GetGitStatusResponse status
}
PushResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.ResolveConflict.

class ResolveConflictRequest {
  + string workspace
  + string path
  + ConflictChoice choice
}
ResolveConflictRequest --> `ConflictChoice`

%% Response message for WorkspaceService.ResolveConflict.

class ResolveConflictResponse {
  + GetGitStatusResponse status
}
ResolveConflictResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.CompleteMerge.

class CompleteMergeRequest {
  + string workspace
}

%% Response message for WorkspaceService.CompleteMerge.

class CompleteMergeResponse {
  + GetGitStatusResponse status
}
CompleteMergeResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.AbortMerge.

class AbortMergeRequest {
  + string workspace
}

%% Response message for WorkspaceService.AbortMerge.

class AbortMergeResponse {
  + GetGitStatusResponse status
}
AbortMergeResponse --> `GetGitStatusResponse`

%% A branch the workspace can switch to or merge.

class Branch {
  + string name
  + bool remote
  + bool current
  + string upstream
  + string subject
  + google.protobuf.Timestamp time
}

%% Request message for WorkspaceService.ListBranches.

class ListBranchesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListBranches.

class ListBranchesResponse {
  + List~Branch~ branches
}
ListBranchesResponse --> `Branch`

%% Request message for WorkspaceService.SwitchBranch.

class SwitchBranchRequest {
  + string workspace
  + string branch
}

%% Response message for WorkspaceService.SwitchBranch.

class SwitchBranchResponse {
  + GetGitStatusResponse status
}
SwitchBranchResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.CreateBranch.

class CreateBranchRequest {
  + string workspace
  + string branch
}

%% Response message for WorkspaceService.CreateBranch.

class CreateBranchResponse {
  + GetGitStatusResponse status
}
CreateBranchResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.MergeBranch.

class MergeBranchRequest {
  + string workspace
  + string branch
}

%% Response message for WorkspaceService.MergeBranch.

class MergeBranchResponse {
  + PullOutcome outcome
  + int32 commits
  + GetGitStatusResponse status
}
MergeBranchResponse --> `PullOutcome`
MergeBranchResponse --> `GetGitStatusResponse`

%% Request message for WorkspaceService.DraftManifest.

class DraftManifestRequest {
  + string workspace
  + string kind
  + string name
  + string description
  + string current
  + string request
  + string language
}

%% Response message for WorkspaceService.DraftManifest.

class DraftManifestResponse {
  + string text
  + List~string~ changes
  + string problem
}

%% A rule file: a gate (when set) or an instruction rule.

class RuleFile {
  + string name
  + string path
  + string when
  + string action
  + int32 order
  + List~string~ agents
  + string description
  + List~string~ paths
  + string text
  + string problem
  + bool editable
}

%% What Studio's rule form edits.

class RuleSpec {
  + string name
  + string when
  + string action
  + int32 order
  + List~string~ agents
  + string description
  + List~string~ paths
  + string text
}

%% Request message for WorkspaceService.ListRules.

class ListRulesRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListRules.

class ListRulesResponse {
  + List~RuleFile~ rules
  + string dir
}
ListRulesResponse --> `RuleFile`

%% Request message for WorkspaceService.SaveRule.

class SaveRuleRequest {
  + string workspace
  + string previous_name
  + RuleSpec rule
}
SaveRuleRequest --> `RuleSpec`

%% Response message for WorkspaceService.SaveRule.

class SaveRuleResponse {
  + RuleFile rule
  + List~string~ problems
}
SaveRuleResponse --> `RuleFile`

%% Request message for WorkspaceService.DeleteRule.

class DeleteRuleRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.DeleteRule.

class DeleteRuleResponse {
}

%% Request message for WorkspaceService.ReorderRules.

class ReorderRulesRequest {
  + string workspace
  + List~string~ names
}

%% Response message for WorkspaceService.ReorderRules.

class ReorderRulesResponse {
}

%% Request message for WorkspaceService.TryRule.

class TryRuleRequest {
  + string workspace
  + RuleSpec rule
  + string sample
}
TryRuleRequest --> `RuleSpec`

%% Response message for WorkspaceService.TryRule.

class TryRuleResponse {
  + bool pass
  + string reason
  + string problem
}

%% The limits guardrail's limits; zero or empty means none of that kind.

class GuardrailLimits {
  + double max_cost_usd
  + int32 max_turns
  + int32 max_files_changed
  + List~string~ allowed_domains
  + List~string~ commands
}

%% A guardrail file, or a built-in guardrail without one (its defaults).

class GuardrailFile {
  + string name
  + string path
  + string builtin
  + string stage
  + string action
  + List~string~ agents
  + List~string~ tools
  + string description
  + bool pii
  + bool judge
  + GuardrailLimits limits
  + string text
  + string problem
  + bool editable
  + bool off
}
GuardrailFile --> `GuardrailLimits`

%% A built-in guardrail: on by default.

class BuiltinGuardrail {
  + string id
  + string stage
  + string default_action
  + List~string~ actions
  + GuardrailFile file
}
BuiltinGuardrail --> `GuardrailFile`

%% What Studio's guardrail form edits.

class GuardrailSpec {
  + string name
  + string builtin
  + string stage
  + string action
  + List~string~ agents
  + List~string~ tools
  + string description
  + bool pii
  + bool judge
  + GuardrailLimits limits
  + string text
  + bool off
}
GuardrailSpec --> `GuardrailLimits`

%% Request message for WorkspaceService.ListGuardrails.

class ListGuardrailsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListGuardrails.

class ListGuardrailsResponse {
  + List~BuiltinGuardrail~ builtins
  + List~GuardrailFile~ guardrails
  + string dir
}
ListGuardrailsResponse --> `BuiltinGuardrail`
ListGuardrailsResponse --> `GuardrailFile`

%% Request message for WorkspaceService.SaveGuardrail.

class SaveGuardrailRequest {
  + string workspace
  + string previous_name
  + GuardrailSpec guardrail
}
SaveGuardrailRequest --> `GuardrailSpec`

%% Response message for WorkspaceService.SaveGuardrail.

class SaveGuardrailResponse {
  + GuardrailFile guardrail
  + List~string~ problems
}
SaveGuardrailResponse --> `GuardrailFile`

%% Request message for WorkspaceService.DeleteGuardrail.

class DeleteGuardrailRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.DeleteGuardrail.

class DeleteGuardrailResponse {
}

%% Request message for WorkspaceService.TryGuardrail.

class TryGuardrailRequest {
  + string workspace
  + GuardrailSpec guardrail
  + string sample
}
TryGuardrailRequest --> `GuardrailSpec`

%% Response message for WorkspaceService.TryGuardrail.

class TryGuardrailResponse {
  + bool pass
  + string reason
  + string problem
}

%% A row of an eval's table.

class EvalCase {
  + string id
  + string name
  + string prompt
  + string output
  + string type
  + double threshold
  + string scope
}

%% An eval file in .agents/evals.

class EvalFile {
  + string name
  + string path
  + string description
  + List~string~ agents
  + List~string~ skills
  + string near
  + List~string~ allow
  + List~EvalCase~ cases
  + string problem
  + EvalRun last_run
}
EvalFile --> `EvalCase`
EvalFile --> `EvalRun`

%% What Studio's eval form edits.

class EvalSpec {
  + string name
  + string description
  + List~string~ agents
  + List~string~ skills
  + string near
  + List~string~ allow
  + List~EvalCase~ cases
}
EvalSpec --> `EvalCase`

%% One case run by one agent, and its score.

class EvalResult {
  + string case
  + string name
  + string agent
  + string type
  + string scope
  + string status
  + double score
  + double threshold
  + string prompt
  + string expected
  + string output
  + string reason
  + List~string~ refusals
  + double cost_usd
  + google.protobuf.Duration duration
}

%% A run of an eval.

class EvalRun {
  + string id
  + string eval
  + google.protobuf.Timestamp started
  + google.protobuf.Duration duration
  + string status
  + List~EvalResult~ results
  + double cost_usd
  + string error
  + Map~string,  int32~ counts
}
EvalRun --> `EvalResult`

%% Request message for WorkspaceService.ListEvals.

class ListEvalsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListEvals.

class ListEvalsResponse {
  + List~EvalFile~ evals
  + string dir
}
ListEvalsResponse --> `EvalFile`

%% Request message for WorkspaceService.SaveEval.

class SaveEvalRequest {
  + string workspace
  + string previous_name
  + EvalSpec eval
}
SaveEvalRequest --> `EvalSpec`

%% Response message for WorkspaceService.SaveEval.

class SaveEvalResponse {
  + EvalFile eval
  + List~string~ problems
}
SaveEvalResponse --> `EvalFile`

%% Request message for WorkspaceService.DeleteEval.

class DeleteEvalRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.DeleteEval.

class DeleteEvalResponse {
}

%% Request message for WorkspaceService.RunEval.

class RunEvalRequest {
  + string workspace
  + string name
  + List~string~ cases
}

%% Response message for WorkspaceService.RunEval: the run as it starts, each result, then the finished run.

class RunEvalResponse {
  + Oneof~EvalRun~ started [oneof: event]
  + Oneof~EvalResult~ result [oneof: event]
  + Oneof~EvalRun~ finished [oneof: event]
}
RunEvalResponse --> `EvalRun`
RunEvalResponse --> `EvalResult`
RunEvalResponse --> `EvalRun`

%% Request message for WorkspaceService.ListEvalRuns.

class ListEvalRunsRequest {
  + string workspace
  + string name
  + int32 limit
}

%% Response message for WorkspaceService.ListEvalRuns.

class ListEvalRunsResponse {
  + List~EvalRun~ runs
}
ListEvalRunsResponse --> `EvalRun`

%% Request message for WorkspaceService.DraftEvalCases.

class DraftEvalCasesRequest {
  + string workspace
  + string agent
  + string request
  + List~EvalCase~ existing
}
DraftEvalCasesRequest --> `EvalCase`

%% Response message for WorkspaceService.DraftEvalCases.

class DraftEvalCasesResponse {
  + List~EvalCase~ cases
  + string problem
}
DraftEvalCasesResponse --> `EvalCase`

%% A workflow's step.

class FlowNode {
  + string id
  + string type
  + string title
  + double x
  + double y
  + string agent
  + List~string~ skills
  + string instructions
  + List~string~ rules
  + string skill
  + string script
  + List~string~ args
  + string path
  + List~FlowField~ fields
  + int32 retry_attempts
  + string retry_delay
  + string timeout
  + string server
  + string tool
  + string arguments_json
  + string url
  + string method
  + List~FlowPair~ query
  + List~FlowPair~ headers
  + string body
  + string json_body
  + FlowAuth auth
  + string workflow
  + string for_each
  + int32 concurrency
  + string form_json
  + string wait
  + string until
}
FlowNode --> `FlowField`
FlowNode --> `FlowPair`
FlowNode --> `FlowPair`
FlowNode --> `FlowAuth`

%% A paused workflow run's task: a human task's form waiting for an answer, or a timer waiting for its time.

class HumanTask {
  + string id
  + string run
  + string workspace
  + string workflow
  + string step
  + string title
  + string kind
  + string message
  + string a2ui_json
  + google.protobuf.Timestamp fire_at
  + google.protobuf.Timestamp created
  + string session_id
}

%% Request message for WorkspaceService.ListHumanTasks.

class ListHumanTasksRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListHumanTasks.

class ListHumanTasksResponse {
  + List~HumanTask~ tasks
  + string alerts
}
ListHumanTasksResponse --> `HumanTask`

%% Request message for WorkspaceService.WatchHumanTasks.

class WatchHumanTasksRequest {
  + string workspace
}

%% Response message for WorkspaceService.WatchHumanTasks: the tasks now (each message the whole list).

class WatchHumanTasksResponse {
  + List~HumanTask~ tasks
  + string alerts
}
WatchHumanTasksResponse --> `HumanTask`

%% Request message for WorkspaceService.AnswerHumanTask.

class AnswerHumanTaskRequest {
  + string workspace
  + string task_id
  + string action_json
  + string data_json
}

%% Response message for WorkspaceService.AnswerHumanTask.

class AnswerHumanTaskResponse {
  + BackgroundRun run
}
AnswerHumanTaskResponse --> `BackgroundRun`

%% A named value: a header, a query parameter.

class FlowPair {
  + string name
  + string value
}

%% How an API call authenticates.

class FlowAuth {
  + string type
  + string token
  + string username
  + string password
  + string name
  + string value
  + string in
  + string token_url
  + string client_id
  + string client_secret
  + List~string~ scopes
  + string audience
}

%% A value an extract step pulls out.

class FlowField {
  + string name
  + string type
  + string description
}

%% A link carrying a step's output to another.

class FlowEdge {
  + string from
  + string to
  + string when
  + string if
  + bool default
  + bool error
  + string label
}

%% A workflow file in .agents/workflows.

class WorkflowFile {
  + string name
  + string path
  + string description
  + List~FlowNode~ nodes
  + List~FlowEdge~ edges
  + string problem
  + string mode
}
WorkflowFile --> `FlowNode`
WorkflowFile --> `FlowEdge`

%% Request message for WorkspaceService.ListWorkflows.

class ListWorkflowsRequest {
  + string workspace
}

%% Response message for WorkspaceService.ListWorkflows.

class ListWorkflowsResponse {
  + List~WorkflowFile~ workflows
  + string dir
}
ListWorkflowsResponse --> `WorkflowFile`

%% Request message for WorkspaceService.SaveWorkflow.

class SaveWorkflowRequest {
  + string workspace
  + string previous_name
  + WorkflowFile workflow
}
SaveWorkflowRequest --> `WorkflowFile`

%% Response message for WorkspaceService.SaveWorkflow.

class SaveWorkflowResponse {
  + WorkflowFile workflow
  + List~string~ problems
}
SaveWorkflowResponse --> `WorkflowFile`

%% Request message for WorkspaceService.DeleteWorkflow.

class DeleteWorkflowRequest {
  + string workspace
  + string name
}

%% Response message for WorkspaceService.DeleteWorkflow.

class DeleteWorkflowResponse {
}

%% A workflow run's receipt (spec_workflows_043 WF-19): its envelope (what started it, when, on what) and routing slip (each step's run, in the order they ran), with what it spent.

class WorkflowRun {
  + string id
  + string workspace
  + string workflow
  + string origin
  + string session_id
  + string input
  + google.protobuf.Timestamp started
  + google.protobuf.Timestamp ended
  + string status
  + string error
  + string output
  + Usage usage
  + List~string~ models
  + List~WorkflowRunStep~ steps
  + List~WorkflowRunEvent~ events
  + string background_id
  + int32 approvals
  + string mode
}
WorkflowRun --> `Usage`
WorkflowRun --> `WorkflowRunStep`
WorkflowRun --> `WorkflowRunEvent`

%% One run of a workflow's step.

class WorkflowRunStep {
  + string id
  + string title
  + string type
  + string status
  + google.protobuf.Timestamp started
  + google.protobuf.Timestamp ended
  + int32 attempts
  + string agent
  + List~string~ models
  + Usage usage
  + string output
  + string stream
  + string error
}
WorkflowRunStep --> `Usage`

%% Something that happened in a workflow run.

class WorkflowRunEvent {
  + google.protobuf.Timestamp at
  + string step
  + string kind
  + string text
  + bool error
}

%% Request message for WorkspaceService.ListWorkflowRuns.

class ListWorkflowRunsRequest {
  + string workspace
  + string workflow
  + int32 limit
}

%% Response message for WorkspaceService.ListWorkflowRuns.

class ListWorkflowRunsResponse {
  + List~WorkflowRun~ runs
}
ListWorkflowRunsResponse --> `WorkflowRun`

%% Request message for WorkspaceService.GetWorkflowRun.

class GetWorkflowRunRequest {
  + string workspace
  + string id
}

%% Response message for WorkspaceService.GetWorkflowRun.

class GetWorkflowRunResponse {
  + WorkflowRun run
}
GetWorkflowRunResponse --> `WorkflowRun`

%% Request message for WorkspaceService.WatchWorkflowRun.

class WatchWorkflowRunRequest {
  + string workspace
  + string id
}

%% Response message for WorkspaceService.WatchWorkflowRun.

class WatchWorkflowRunResponse {
  + WorkflowRun run
}
WatchWorkflowRunResponse --> `WorkflowRun`

%% Request message for WorkspaceService.WatchWorkflowRuns.

class WatchWorkflowRunsRequest {
  + string workspace
}

%% Response message for WorkspaceService.WatchWorkflowRuns.

class WatchWorkflowRunsResponse {
  + List~WorkflowRun~ runs
}
WatchWorkflowRunsResponse --> `WorkflowRun`

%% Request message for WorkspaceService.StopWorkflowRun.

class StopWorkflowRunRequest {
  + string workspace
  + string id
}

%% Response message for WorkspaceService.StopWorkflowRun.

class StopWorkflowRunResponse {
}

%% A workspace's dashboard (spec_health_044).

class WorkspaceHealth {
  + google.protobuf.Timestamp at
  + List~HealthItem~ items
  + List~HealthDay~ days
  + List~HealthSignal~ signals
  + double overall
  + Map~string,  double~ by_kind
  + double previous_overall
  + google.protobuf.Timestamp last_check
  + double last_cost_usd
  + string skipped
  + string model
  + string schedule
  + google.protobuf.Timestamp next
  + double max_cost_usd
  + bool checking
  + HealthCheckProgress progress
  + int32 last_judged
  + List~string~ last_errors
}
WorkspaceHealth --> `HealthItem`
WorkspaceHealth --> `HealthDay`
WorkspaceHealth --> `HealthSignal`
WorkspaceHealth --> `HealthCheckProgress`

%% How far a check going is.

class HealthCheckProgress {
  + string item
  + int32 index
  + int32 total
  + double cost_usd
}

%% One agent, skill, rule, guardrail, eval, workflow or worker.

class HealthItem {
  + string kind
  + string name
  + string path
  + string detail
  + string problem
  + List~string~ flags
  + int32 uses
  + int32 fired
  + HealthRuns runs
  + HealthEvals evals
  + List~int32~ daily
  + HealthVerdict verdict
  + List~double~ history
}
HealthItem --> `HealthRuns`
HealthItem --> `HealthEvals`
HealthItem --> `HealthVerdict`

%% A workflow's or a worker's runs in the last 30 days.

class HealthRuns {
  + int32 runs
  + int32 done
  + int32 failed
  + int32 stopped
  + double cost_usd
  + int64 median_ms
  + google.protobuf.Timestamp last
  + string failing_step
}

%% An agent's or an eval's latest eval results.

class HealthEvals {
  + int32 runs
  + google.protobuf.Timestamp last
  + int32 passed
  + int32 cases
}

%% The judge's verdict on an item.

class HealthVerdict {
  + string model
  + google.protobuf.Timestamp at
  + List~HealthScore~ scores
  + double overall
  + string grade
  + string summary
  + List~string~ fixes
  + double cost_usd
  + bool current
}
HealthVerdict --> `HealthScore`

%% One rubric line's score.

class HealthScore {
  + string line
  + int32 score
  + string reason
}

%% One day's runs.

class HealthDay {
  + string date
  + int32 done
  + int32 failed
  + int32 stopped
  + double cost_usd
}

%% A safety signal: the reviewer's denials, a rule's or a guardrail's decisions, by what they were about.

class HealthSignal {
  + string kind
  + string about
  + int32 count
  + google.protobuf.Timestamp last
  + string detail
}

%% Request message for WorkspaceService.GetWorkspaceHealth.

class GetWorkspaceHealthRequest {
  + string workspace
}

%% Response message for WorkspaceService.GetWorkspaceHealth.

class GetWorkspaceHealthResponse {
  + WorkspaceHealth health
}
GetWorkspaceHealthResponse --> `WorkspaceHealth`

%% Request message for WorkspaceService.WatchWorkspaceHealth.

class WatchWorkspaceHealthRequest {
  + string workspace
}

%% Response message for WorkspaceService.WatchWorkspaceHealth.

class WatchWorkspaceHealthResponse {
  + WorkspaceHealth health
}
WatchWorkspaceHealthResponse --> `WorkspaceHealth`

%% Which items a check judges: kinds, items ("kind/name"), or all; force re-judges unchanged ones.

class HealthCheckScope {
  + List~string~ kinds
  + List~string~ items
  + bool force
}

%% Request message for WorkspaceService.EstimateHealthCheck.

class EstimateHealthCheckRequest {
  + string workspace
  + HealthCheckScope scope
}
EstimateHealthCheckRequest --> `HealthCheckScope`

%% Response message for WorkspaceService.EstimateHealthCheck.

class EstimateHealthCheckResponse {
  + int32 items
  + double cost_usd
  + bool priced
}

%% Request message for WorkspaceService.CheckWorkspaceHealth.

class CheckWorkspaceHealthRequest {
  + string workspace
  + HealthCheckScope scope
}
CheckWorkspaceHealthRequest --> `HealthCheckScope`

%% Response message for WorkspaceService.CheckWorkspaceHealth: one item's verdict (or why it has none), then a last one with done.

class CheckWorkspaceHealthResponse {
  + string item
  + int32 index
  + int32 total
  + HealthVerdict verdict
  + string error
  + double cost_usd
  + bool done
  + int32 judged
}
CheckWorkspaceHealthResponse --> `HealthVerdict`

%% Request message for WorkspaceService.StopHealthCheck.

class StopHealthCheckRequest {
  + string workspace
}

%% Response message for WorkspaceService.StopHealthCheck.

class StopHealthCheckResponse {
}

%% Request message for WorkspaceService.StartHealthCheck.

class StartHealthCheckRequest {
  + string workspace
  + HealthCheckScope scope
}
StartHealthCheckRequest --> `HealthCheckScope`

%% Response message for WorkspaceService.StartHealthCheck.

class StartHealthCheckResponse {
}

%% A composer conversation as it is.

class ComposeSession {
  + string id
  + string kind
  + List~ComposeTurn~ turns
  + bool asking
  + ComposeDraft draft
  + double cost_usd
}
ComposeSession --> `ComposeTurn`
ComposeSession --> `ComposeDraft`

%% One message of a composer conversation: the user's, or the composer's (a question with its suggested answers, or a draft's summary).

class ComposeTurn {
  + string role
  + string text
  + List~string~ options
}

%% A component the composer wrote: its name, a summary, its file, what the kind's checks still find wrong, and for a workflow the workflow itself.

class ComposeDraft {
  + string name
  + string summary
  + string file
  + List~string~ problems
  + WorkflowFile workflow
}
ComposeDraft --> `WorkflowFile`

%% Request message for WorkspaceService.StartCompose.

class StartComposeRequest {
  + string workspace
  + string kind
  + string request
  + string current
}

%% Response message for WorkspaceService.StartCompose.

class StartComposeResponse {
  + ComposeSession session
}
StartComposeResponse --> `ComposeSession`

%% Request message for WorkspaceService.AnswerCompose.

class AnswerComposeRequest {
  + string workspace
  + string id
  + string answer
}

%% Response message for WorkspaceService.AnswerCompose.

class AnswerComposeResponse {
  + ComposeSession session
}
AnswerComposeResponse --> `ComposeSession`

%% Request message for WorkspaceService.DropCompose.

class DropComposeRequest {
  + string workspace
  + string id
}

%% Response message for WorkspaceService.DropCompose.

class DropComposeResponse {
}
%% SuggestionKind is what a welcome tile does. The state kinds carry data for the front end to word in its own language; IDEA carries text.

class SuggestionKind{
  <<enumeration>>
  SUGGESTION_KIND_UNSPECIFIED
  SUGGESTION_KIND_SETUP
  SUGGESTION_KIND_CONTINUE
  SUGGESTION_KIND_CHANGES
  SUGGESTION_KIND_WORKER_FAILED
  SUGGESTION_KIND_IDEA
  SUGGESTION_KIND_HARNESS_UPDATE
}
%% AgentScope is where an agent's file is kept.

class AgentScope{
  <<enumeration>>
  AGENT_SCOPE_UNSPECIFIED
  AGENT_SCOPE_WORKSPACE
  AGENT_SCOPE_USER
}
%% What a repository is in the middle of.

class GitOperation{
  <<enumeration>>
  GIT_OPERATION_UNSPECIFIED
  GIT_OPERATION_MERGE
  GIT_OPERATION_REBASE
}
%% How a pull went.

class PullOutcome{
  <<enumeration>>
  PULL_OUTCOME_UNSPECIFIED
  PULL_OUTCOME_UP_TO_DATE
  PULL_OUTCOME_FAST_FORWARD
  PULL_OUTCOME_MERGED
  PULL_OUTCOME_REBASED
  PULL_OUTCOME_CONFLICTS
}
%% How a conflicted file is settled.

class ConflictChoice{
  <<enumeration>>
  CONFLICT_CHOICE_UNSPECIFIED
  CONFLICT_CHOICE_MINE
  CONFLICT_CHOICE_THEIRS
  CONFLICT_CHOICE_RESOLVED
}
class WorkspaceService {
  <<service>>
  +GetServiceInfo(GetServiceInfoRequest) GetServiceInfoResponse
  +Shutdown(ShutdownRequest) ShutdownResponse
  +ListLogDays(ListLogDaysRequest) ListLogDaysResponse
  +ReadLog(ReadLogRequest) ReadLogResponse
  +DeleteLogDay(DeleteLogDayRequest) DeleteLogDayResponse
  +ListWorkspaces(ListWorkspacesRequest) ListWorkspacesResponse
  +CloseWorkspace(CloseWorkspaceRequest) CloseWorkspaceResponse
  +GetSandbox(GetSandboxRequest) GetSandboxResponse
  +ListAgents(ListAgentsRequest) ListAgentsResponse
  +SetAgent(SetAgentRequest) SetAgentResponse
  +GetSuggestions(GetSuggestionsRequest) GetSuggestionsResponse
  +ListAgentFiles(ListAgentFilesRequest) ListAgentFilesResponse
  +SaveAgentFile(SaveAgentFileRequest) SaveAgentFileResponse
  +DeleteAgentFile(DeleteAgentFileRequest) DeleteAgentFileResponse
  +GetModel(GetModelRequest) GetModelResponse
  +SetModel(SetModelRequest) SetModelResponse
  +PinModel(PinModelRequest) PinModelResponse
  +UnpinModel(UnpinModelRequest) UnpinModelResponse
  +GetModelSettings(GetModelSettingsRequest) GetModelSettingsResponse
  +UpdateModelSettings(UpdateModelSettingsRequest) UpdateModelSettingsResponse
  +GetSettings(GetSettingsRequest) GetSettingsResponse
  +GetGitStatus(GetGitStatusRequest) GetGitStatusResponse
  +InitGitRepo(InitGitRepoRequest) InitGitRepoResponse
  +DraftCommit(DraftCommitRequest) DraftCommitResponse
  +Commit(CommitRequest) CommitResponse
  +FetchRemote(FetchRemoteRequest) FetchRemoteResponse
  +Pull(PullRequest) PullResponse
  +Push(PushRequest) PushResponse
  +ResolveConflict(ResolveConflictRequest) ResolveConflictResponse
  +CompleteMerge(CompleteMergeRequest) CompleteMergeResponse
  +AbortMerge(AbortMergeRequest) AbortMergeResponse
  +ListBranches(ListBranchesRequest) ListBranchesResponse
  +SwitchBranch(SwitchBranchRequest) SwitchBranchResponse
  +CreateBranch(CreateBranchRequest) CreateBranchResponse
  +MergeBranch(MergeBranchRequest) MergeBranchResponse
  +SetSetting(SetSettingRequest) SetSettingResponse
  +SetPermissionMode(SetPermissionModeRequest) SetPermissionModeResponse
  +ListCommands(ListCommandsRequest) ListCommandsResponse
  +ListPermissionRules(ListPermissionRulesRequest) ListPermissionRulesResponse
  +AddPermissionRule(AddPermissionRuleRequest) AddPermissionRuleResponse
  +RemovePermissionRule(RemovePermissionRuleRequest) RemovePermissionRuleResponse
  +ListSkills(ListSkillsRequest) ListSkillsResponse
  +GetSkill(GetSkillRequest) GetSkillResponse
  +GetSkillFile(GetSkillFileRequest) GetSkillFileResponse
  +SaveSkill(SaveSkillRequest) SaveSkillResponse
  +DeleteSkill(DeleteSkillRequest) DeleteSkillResponse
  +ReadSkillFile(ReadSkillFileRequest) ReadSkillFileResponse
  +WriteSkillFile(WriteSkillFileRequest) WriteSkillFileResponse
  +DeleteSkillFile(DeleteSkillFileRequest) DeleteSkillFileResponse
  +CopySkill(CopySkillRequest) CopySkillResponse
  +RunSkillScript(RunSkillScriptRequest) RunSkillScriptResponse
  +ListRules(ListRulesRequest) ListRulesResponse
  +SaveRule(SaveRuleRequest) SaveRuleResponse
  +DeleteRule(DeleteRuleRequest) DeleteRuleResponse
  +ReorderRules(ReorderRulesRequest) ReorderRulesResponse
  +TryRule(TryRuleRequest) TryRuleResponse
  +ListGuardrails(ListGuardrailsRequest) ListGuardrailsResponse
  +SaveGuardrail(SaveGuardrailRequest) SaveGuardrailResponse
  +DeleteGuardrail(DeleteGuardrailRequest) DeleteGuardrailResponse
  +TryGuardrail(TryGuardrailRequest) TryGuardrailResponse
  +ListEvals(ListEvalsRequest) ListEvalsResponse
  +SaveEval(SaveEvalRequest) SaveEvalResponse
  +DeleteEval(DeleteEvalRequest) DeleteEvalResponse
  +RunEval(RunEvalRequest) Stream~RunEvalResponse~
  +ListEvalRuns(ListEvalRunsRequest) ListEvalRunsResponse
  +DraftEvalCases(DraftEvalCasesRequest) DraftEvalCasesResponse
  +ListWorkflows(ListWorkflowsRequest) ListWorkflowsResponse
  +SaveWorkflow(SaveWorkflowRequest) SaveWorkflowResponse
  +DeleteWorkflow(DeleteWorkflowRequest) DeleteWorkflowResponse
  +ListWorkflowRuns(ListWorkflowRunsRequest) ListWorkflowRunsResponse
  +GetWorkflowRun(GetWorkflowRunRequest) GetWorkflowRunResponse
  +WatchWorkflowRun(WatchWorkflowRunRequest) Stream~WatchWorkflowRunResponse~
  +WatchWorkflowRuns(WatchWorkflowRunsRequest) Stream~WatchWorkflowRunsResponse~
  +StopWorkflowRun(StopWorkflowRunRequest) StopWorkflowRunResponse
  +GetWorkspaceHealth(GetWorkspaceHealthRequest) GetWorkspaceHealthResponse
  +WatchWorkspaceHealth(WatchWorkspaceHealthRequest) Stream~WatchWorkspaceHealthResponse~
  +EstimateHealthCheck(EstimateHealthCheckRequest) EstimateHealthCheckResponse
  +CheckWorkspaceHealth(CheckWorkspaceHealthRequest) Stream~CheckWorkspaceHealthResponse~
  +StopHealthCheck(StopHealthCheckRequest) StopHealthCheckResponse
  +StartHealthCheck(StartHealthCheckRequest) StartHealthCheckResponse
  +StartCompose(StartComposeRequest) StartComposeResponse
  +AnswerCompose(AnswerComposeRequest) AnswerComposeResponse
  +DropCompose(DropComposeRequest) DropComposeResponse
  +ListHumanTasks(ListHumanTasksRequest) ListHumanTasksResponse
  +WatchHumanTasks(WatchHumanTasksRequest) Stream~WatchHumanTasksResponse~
  +AnswerHumanTask(AnswerHumanTaskRequest) AnswerHumanTaskResponse
  +ListEnvs(ListEnvsRequest) ListEnvsResponse
  +RemoveEnv(RemoveEnvRequest) RemoveEnvResponse
  +PruneEnvs(PruneEnvsRequest) PruneEnvsResponse
  +DraftManifest(DraftManifestRequest) DraftManifestResponse
  +ListMCPServers(ListMCPServersRequest) ListMCPServersResponse
  +RestartMCPServer(RestartMCPServerRequest) RestartMCPServerResponse
  +ListTools(ListToolsRequest) ListToolsResponse
  +ReloadMemory(ReloadMemoryRequest) ReloadMemoryResponse
  +ReloadAgentFiles(ReloadAgentFilesRequest) ReloadAgentFilesResponse
  +AddMemory(AddMemoryRequest) AddMemoryResponse
  +ListLocales(ListLocalesRequest) ListLocalesResponse
  +SetLocale(SetLocaleRequest) SetLocaleResponse
  +ListCheckpoints(ListCheckpointsRequest) ListCheckpointsResponse
  +Undo(UndoRequest) UndoResponse
  +GetDiff(GetDiffRequest) GetDiffResponse
  +ListApprovals(ListApprovalsRequest) ListApprovalsResponse
  +RevokeApprovals(RevokeApprovalsRequest) RevokeApprovalsResponse
  +ListProcesses(ListProcessesRequest) ListProcessesResponse
  +GetProcessOutput(GetProcessOutputRequest) GetProcessOutputResponse
  +KillProcess(KillProcessRequest) KillProcessResponse
  +AuditShell(AuditShellRequest) AuditShellResponse
  +ListTasks(ListTasksRequest) ListTasksResponse
  +GetTask(GetTaskRequest) GetTaskResponse
  +StopTask(StopTaskRequest) StopTaskResponse
  +WatchTasks(WatchTasksRequest) Stream~WatchTasksResponse~
  +ListTaskRequests(ListTaskRequestsRequest) ListTaskRequestsResponse
  +GetProjectSettings(GetProjectSettingsRequest) GetProjectSettingsResponse
  +TrustProject(TrustProjectRequest) TrustProjectResponse
  +ForgetProjectTrust(ForgetProjectTrustRequest) ForgetProjectTrustResponse
  +TakeProcessNotices(TakeProcessNoticesRequest) TakeProcessNoticesResponse
  +ListStyles(ListStylesRequest) ListStylesResponse
  +ListHooks(ListHooksRequest) ListHooksResponse
  +ListNotes(ListNotesRequest) ListNotesResponse
  +ForgetNote(ForgetNoteRequest) ForgetNoteResponse
  +LoadImage(LoadImageRequest) LoadImageResponse
  +AddImage(AddImageRequest) AddImageResponse
  +GetSearchProvider(GetSearchProviderRequest) GetSearchProviderResponse
  +SearchWeb(SearchWebRequest) SearchWebResponse
  +SearchWorkspace(SearchWorkspaceRequest) SearchWorkspaceResponse
  +GetSearchStatus(GetSearchStatusRequest) GetSearchStatusResponse
  +Reindex(ReindexRequest) ReindexResponse
}
WorkspaceService --> `GetServiceInfoRequest`
WorkspaceService --> `GetServiceInfoResponse`
WorkspaceService --> `ShutdownRequest`
WorkspaceService --> `ShutdownResponse`
WorkspaceService --> `ListLogDaysRequest`
WorkspaceService --> `ListLogDaysResponse`
WorkspaceService --> `ReadLogRequest`
WorkspaceService --> `ReadLogResponse`
WorkspaceService --> `DeleteLogDayRequest`
WorkspaceService --> `DeleteLogDayResponse`
WorkspaceService --> `ListWorkspacesRequest`
WorkspaceService --> `ListWorkspacesResponse`
WorkspaceService --> `CloseWorkspaceRequest`
WorkspaceService --> `CloseWorkspaceResponse`
WorkspaceService --> `GetSandboxRequest`
WorkspaceService --> `GetSandboxResponse`
WorkspaceService --> `ListAgentsRequest`
WorkspaceService --> `ListAgentsResponse`
WorkspaceService --> `SetAgentRequest`
WorkspaceService --> `SetAgentResponse`
WorkspaceService --> `GetSuggestionsRequest`
WorkspaceService --> `GetSuggestionsResponse`
WorkspaceService --> `ListAgentFilesRequest`
WorkspaceService --> `ListAgentFilesResponse`
WorkspaceService --> `SaveAgentFileRequest`
WorkspaceService --> `SaveAgentFileResponse`
WorkspaceService --> `DeleteAgentFileRequest`
WorkspaceService --> `DeleteAgentFileResponse`
WorkspaceService --> `GetModelRequest`
WorkspaceService --> `GetModelResponse`
WorkspaceService --> `SetModelRequest`
WorkspaceService --> `SetModelResponse`
WorkspaceService --> `PinModelRequest`
WorkspaceService --> `PinModelResponse`
WorkspaceService --> `UnpinModelRequest`
WorkspaceService --> `UnpinModelResponse`
WorkspaceService --> `GetModelSettingsRequest`
WorkspaceService --> `GetModelSettingsResponse`
WorkspaceService --> `UpdateModelSettingsRequest`
WorkspaceService --> `UpdateModelSettingsResponse`
WorkspaceService --> `GetSettingsRequest`
WorkspaceService --> `GetSettingsResponse`
WorkspaceService --> `GetGitStatusRequest`
WorkspaceService --> `GetGitStatusResponse`
WorkspaceService --> `InitGitRepoRequest`
WorkspaceService --> `InitGitRepoResponse`
WorkspaceService --> `DraftCommitRequest`
WorkspaceService --> `DraftCommitResponse`
WorkspaceService --> `CommitRequest`
WorkspaceService --> `CommitResponse`
WorkspaceService --> `FetchRemoteRequest`
WorkspaceService --> `FetchRemoteResponse`
WorkspaceService --> `PullRequest`
WorkspaceService --> `PullResponse`
WorkspaceService --> `PushRequest`
WorkspaceService --> `PushResponse`
WorkspaceService --> `ResolveConflictRequest`
WorkspaceService --> `ResolveConflictResponse`
WorkspaceService --> `CompleteMergeRequest`
WorkspaceService --> `CompleteMergeResponse`
WorkspaceService --> `AbortMergeRequest`
WorkspaceService --> `AbortMergeResponse`
WorkspaceService --> `ListBranchesRequest`
WorkspaceService --> `ListBranchesResponse`
WorkspaceService --> `SwitchBranchRequest`
WorkspaceService --> `SwitchBranchResponse`
WorkspaceService --> `CreateBranchRequest`
WorkspaceService --> `CreateBranchResponse`
WorkspaceService --> `MergeBranchRequest`
WorkspaceService --> `MergeBranchResponse`
WorkspaceService --> `SetSettingRequest`
WorkspaceService --> `SetSettingResponse`
WorkspaceService --> `SetPermissionModeRequest`
WorkspaceService --> `SetPermissionModeResponse`
WorkspaceService --> `ListCommandsRequest`
WorkspaceService --> `ListCommandsResponse`
WorkspaceService --> `ListPermissionRulesRequest`
WorkspaceService --> `ListPermissionRulesResponse`
WorkspaceService --> `AddPermissionRuleRequest`
WorkspaceService --> `AddPermissionRuleResponse`
WorkspaceService --> `RemovePermissionRuleRequest`
WorkspaceService --> `RemovePermissionRuleResponse`
WorkspaceService --> `ListSkillsRequest`
WorkspaceService --> `ListSkillsResponse`
WorkspaceService --> `GetSkillRequest`
WorkspaceService --> `GetSkillResponse`
WorkspaceService --> `GetSkillFileRequest`
WorkspaceService --> `GetSkillFileResponse`
WorkspaceService --> `SaveSkillRequest`
WorkspaceService --> `SaveSkillResponse`
WorkspaceService --> `DeleteSkillRequest`
WorkspaceService --> `DeleteSkillResponse`
WorkspaceService --> `ReadSkillFileRequest`
WorkspaceService --> `ReadSkillFileResponse`
WorkspaceService --> `WriteSkillFileRequest`
WorkspaceService --> `WriteSkillFileResponse`
WorkspaceService --> `DeleteSkillFileRequest`
WorkspaceService --> `DeleteSkillFileResponse`
WorkspaceService --> `CopySkillRequest`
WorkspaceService --> `CopySkillResponse`
WorkspaceService --> `RunSkillScriptRequest`
WorkspaceService --> `RunSkillScriptResponse`
WorkspaceService --> `ListRulesRequest`
WorkspaceService --> `ListRulesResponse`
WorkspaceService --> `SaveRuleRequest`
WorkspaceService --> `SaveRuleResponse`
WorkspaceService --> `DeleteRuleRequest`
WorkspaceService --> `DeleteRuleResponse`
WorkspaceService --> `ReorderRulesRequest`
WorkspaceService --> `ReorderRulesResponse`
WorkspaceService --> `TryRuleRequest`
WorkspaceService --> `TryRuleResponse`
WorkspaceService --> `ListGuardrailsRequest`
WorkspaceService --> `ListGuardrailsResponse`
WorkspaceService --> `SaveGuardrailRequest`
WorkspaceService --> `SaveGuardrailResponse`
WorkspaceService --> `DeleteGuardrailRequest`
WorkspaceService --> `DeleteGuardrailResponse`
WorkspaceService --> `TryGuardrailRequest`
WorkspaceService --> `TryGuardrailResponse`
WorkspaceService --> `ListEvalsRequest`
WorkspaceService --> `ListEvalsResponse`
WorkspaceService --> `SaveEvalRequest`
WorkspaceService --> `SaveEvalResponse`
WorkspaceService --> `DeleteEvalRequest`
WorkspaceService --> `DeleteEvalResponse`
WorkspaceService --> `RunEvalRequest`
WorkspaceService --o `RunEvalResponse` : server stream
WorkspaceService --> `ListEvalRunsRequest`
WorkspaceService --> `ListEvalRunsResponse`
WorkspaceService --> `DraftEvalCasesRequest`
WorkspaceService --> `DraftEvalCasesResponse`
WorkspaceService --> `ListWorkflowsRequest`
WorkspaceService --> `ListWorkflowsResponse`
WorkspaceService --> `SaveWorkflowRequest`
WorkspaceService --> `SaveWorkflowResponse`
WorkspaceService --> `DeleteWorkflowRequest`
WorkspaceService --> `DeleteWorkflowResponse`
WorkspaceService --> `ListWorkflowRunsRequest`
WorkspaceService --> `ListWorkflowRunsResponse`
WorkspaceService --> `GetWorkflowRunRequest`
WorkspaceService --> `GetWorkflowRunResponse`
WorkspaceService --> `WatchWorkflowRunRequest`
WorkspaceService --o `WatchWorkflowRunResponse` : server stream
WorkspaceService --> `WatchWorkflowRunsRequest`
WorkspaceService --o `WatchWorkflowRunsResponse` : server stream
WorkspaceService --> `StopWorkflowRunRequest`
WorkspaceService --> `StopWorkflowRunResponse`
WorkspaceService --> `GetWorkspaceHealthRequest`
WorkspaceService --> `GetWorkspaceHealthResponse`
WorkspaceService --> `WatchWorkspaceHealthRequest`
WorkspaceService --o `WatchWorkspaceHealthResponse` : server stream
WorkspaceService --> `EstimateHealthCheckRequest`
WorkspaceService --> `EstimateHealthCheckResponse`
WorkspaceService --> `CheckWorkspaceHealthRequest`
WorkspaceService --o `CheckWorkspaceHealthResponse` : server stream
WorkspaceService --> `StopHealthCheckRequest`
WorkspaceService --> `StopHealthCheckResponse`
WorkspaceService --> `StartHealthCheckRequest`
WorkspaceService --> `StartHealthCheckResponse`
WorkspaceService --> `StartComposeRequest`
WorkspaceService --> `StartComposeResponse`
WorkspaceService --> `AnswerComposeRequest`
WorkspaceService --> `AnswerComposeResponse`
WorkspaceService --> `DropComposeRequest`
WorkspaceService --> `DropComposeResponse`
WorkspaceService --> `ListHumanTasksRequest`
WorkspaceService --> `ListHumanTasksResponse`
WorkspaceService --> `WatchHumanTasksRequest`
WorkspaceService --o `WatchHumanTasksResponse` : server stream
WorkspaceService --> `AnswerHumanTaskRequest`
WorkspaceService --> `AnswerHumanTaskResponse`
WorkspaceService --> `ListEnvsRequest`
WorkspaceService --> `ListEnvsResponse`
WorkspaceService --> `RemoveEnvRequest`
WorkspaceService --> `RemoveEnvResponse`
WorkspaceService --> `PruneEnvsRequest`
WorkspaceService --> `PruneEnvsResponse`
WorkspaceService --> `DraftManifestRequest`
WorkspaceService --> `DraftManifestResponse`
WorkspaceService --> `ListMCPServersRequest`
WorkspaceService --> `ListMCPServersResponse`
WorkspaceService --> `RestartMCPServerRequest`
WorkspaceService --> `RestartMCPServerResponse`
WorkspaceService --> `ListToolsRequest`
WorkspaceService --> `ListToolsResponse`
WorkspaceService --> `ReloadMemoryRequest`
WorkspaceService --> `ReloadMemoryResponse`
WorkspaceService --> `ReloadAgentFilesRequest`
WorkspaceService --> `ReloadAgentFilesResponse`
WorkspaceService --> `AddMemoryRequest`
WorkspaceService --> `AddMemoryResponse`
WorkspaceService --> `ListLocalesRequest`
WorkspaceService --> `ListLocalesResponse`
WorkspaceService --> `SetLocaleRequest`
WorkspaceService --> `SetLocaleResponse`
WorkspaceService --> `ListCheckpointsRequest`
WorkspaceService --> `ListCheckpointsResponse`
WorkspaceService --> `UndoRequest`
WorkspaceService --> `UndoResponse`
WorkspaceService --> `GetDiffRequest`
WorkspaceService --> `GetDiffResponse`
WorkspaceService --> `ListApprovalsRequest`
WorkspaceService --> `ListApprovalsResponse`
WorkspaceService --> `RevokeApprovalsRequest`
WorkspaceService --> `RevokeApprovalsResponse`
WorkspaceService --> `ListProcessesRequest`
WorkspaceService --> `ListProcessesResponse`
WorkspaceService --> `GetProcessOutputRequest`
WorkspaceService --> `GetProcessOutputResponse`
WorkspaceService --> `KillProcessRequest`
WorkspaceService --> `KillProcessResponse`
WorkspaceService --> `AuditShellRequest`
WorkspaceService --> `AuditShellResponse`
WorkspaceService --> `ListTasksRequest`
WorkspaceService --> `ListTasksResponse`
WorkspaceService --> `GetTaskRequest`
WorkspaceService --> `GetTaskResponse`
WorkspaceService --> `StopTaskRequest`
WorkspaceService --> `StopTaskResponse`
WorkspaceService --> `WatchTasksRequest`
WorkspaceService --o `WatchTasksResponse` : server stream
WorkspaceService --> `ListTaskRequestsRequest`
WorkspaceService --> `ListTaskRequestsResponse`
WorkspaceService --> `GetProjectSettingsRequest`
WorkspaceService --> `GetProjectSettingsResponse`
WorkspaceService --> `TrustProjectRequest`
WorkspaceService --> `TrustProjectResponse`
WorkspaceService --> `ForgetProjectTrustRequest`
WorkspaceService --> `ForgetProjectTrustResponse`
WorkspaceService --> `TakeProcessNoticesRequest`
WorkspaceService --> `TakeProcessNoticesResponse`
WorkspaceService --> `ListStylesRequest`
WorkspaceService --> `ListStylesResponse`
WorkspaceService --> `ListHooksRequest`
WorkspaceService --> `ListHooksResponse`
WorkspaceService --> `ListNotesRequest`
WorkspaceService --> `ListNotesResponse`
WorkspaceService --> `ForgetNoteRequest`
WorkspaceService --> `ForgetNoteResponse`
WorkspaceService --> `LoadImageRequest`
WorkspaceService --> `LoadImageResponse`
WorkspaceService --> `AddImageRequest`
WorkspaceService --> `AddImageResponse`
WorkspaceService --> `GetSearchProviderRequest`
WorkspaceService --> `GetSearchProviderResponse`
WorkspaceService --> `SearchWebRequest`
WorkspaceService --> `SearchWebResponse`
WorkspaceService --> `SearchWorkspaceRequest`
WorkspaceService --> `SearchWorkspaceResponse`
WorkspaceService --> `GetSearchStatusRequest`
WorkspaceService --> `GetSearchStatusResponse`
WorkspaceService --> `ReindexRequest`
WorkspaceService --> `ReindexResponse`

classDiagram
direction LR
class WorkspaceService {
  <<service>>
  +GetServiceInfo(GetServiceInfoRequest) GetServiceInfoResponse
  +Shutdown(ShutdownRequest) ShutdownResponse
  +ListLogDays(ListLogDaysRequest) ListLogDaysResponse
  +ReadLog(ReadLogRequest) ReadLogResponse
  +DeleteLogDay(DeleteLogDayRequest) DeleteLogDayResponse
  +ListWorkspaces(ListWorkspacesRequest) ListWorkspacesResponse
  +CloseWorkspace(CloseWorkspaceRequest) CloseWorkspaceResponse
  +GetSandbox(GetSandboxRequest) GetSandboxResponse
  +ListAgents(ListAgentsRequest) ListAgentsResponse
  +SetAgent(SetAgentRequest) SetAgentResponse
  +GetSuggestions(GetSuggestionsRequest) GetSuggestionsResponse
  +ListAgentFiles(ListAgentFilesRequest) ListAgentFilesResponse
  +SaveAgentFile(SaveAgentFileRequest) SaveAgentFileResponse
  +DeleteAgentFile(DeleteAgentFileRequest) DeleteAgentFileResponse
  +GetModel(GetModelRequest) GetModelResponse
  +SetModel(SetModelRequest) SetModelResponse
  +PinModel(PinModelRequest) PinModelResponse
  +UnpinModel(UnpinModelRequest) UnpinModelResponse
  +GetModelSettings(GetModelSettingsRequest) GetModelSettingsResponse
  +UpdateModelSettings(UpdateModelSettingsRequest) UpdateModelSettingsResponse
  +GetSettings(GetSettingsRequest) GetSettingsResponse
  +GetGitStatus(GetGitStatusRequest) GetGitStatusResponse
  +InitGitRepo(InitGitRepoRequest) InitGitRepoResponse
  +DraftCommit(DraftCommitRequest) DraftCommitResponse
  +Commit(CommitRequest) CommitResponse
  +FetchRemote(FetchRemoteRequest) FetchRemoteResponse
  +Pull(PullRequest) PullResponse
  +Push(PushRequest) PushResponse
  +ResolveConflict(ResolveConflictRequest) ResolveConflictResponse
  +CompleteMerge(CompleteMergeRequest) CompleteMergeResponse
  +AbortMerge(AbortMergeRequest) AbortMergeResponse
  +ListBranches(ListBranchesRequest) ListBranchesResponse
  +SwitchBranch(SwitchBranchRequest) SwitchBranchResponse
  +CreateBranch(CreateBranchRequest) CreateBranchResponse
  +MergeBranch(MergeBranchRequest) MergeBranchResponse
  +SetSetting(SetSettingRequest) SetSettingResponse
  +SetPermissionMode(SetPermissionModeRequest) SetPermissionModeResponse
  +ListCommands(ListCommandsRequest) ListCommandsResponse
  +ListPermissionRules(ListPermissionRulesRequest) ListPermissionRulesResponse
  +AddPermissionRule(AddPermissionRuleRequest) AddPermissionRuleResponse
  +RemovePermissionRule(RemovePermissionRuleRequest) RemovePermissionRuleResponse
  +ListSkills(ListSkillsRequest) ListSkillsResponse
  +GetSkill(GetSkillRequest) GetSkillResponse
  +GetSkillFile(GetSkillFileRequest) GetSkillFileResponse
  +SaveSkill(SaveSkillRequest) SaveSkillResponse
  +DeleteSkill(DeleteSkillRequest) DeleteSkillResponse
  +ReadSkillFile(ReadSkillFileRequest) ReadSkillFileResponse
  +WriteSkillFile(WriteSkillFileRequest) WriteSkillFileResponse
  +DeleteSkillFile(DeleteSkillFileRequest) DeleteSkillFileResponse
  +CopySkill(CopySkillRequest) CopySkillResponse
  +RunSkillScript(RunSkillScriptRequest) RunSkillScriptResponse
  +ListRules(ListRulesRequest) ListRulesResponse
  +SaveRule(SaveRuleRequest) SaveRuleResponse
  +DeleteRule(DeleteRuleRequest) DeleteRuleResponse
  +ReorderRules(ReorderRulesRequest) ReorderRulesResponse
  +TryRule(TryRuleRequest) TryRuleResponse
  +ListGuardrails(ListGuardrailsRequest) ListGuardrailsResponse
  +SaveGuardrail(SaveGuardrailRequest) SaveGuardrailResponse
  +DeleteGuardrail(DeleteGuardrailRequest) DeleteGuardrailResponse
  +TryGuardrail(TryGuardrailRequest) TryGuardrailResponse
  +ListEvals(ListEvalsRequest) ListEvalsResponse
  +SaveEval(SaveEvalRequest) SaveEvalResponse
  +DeleteEval(DeleteEvalRequest) DeleteEvalResponse
  +RunEval(RunEvalRequest) Stream~RunEvalResponse~
  +ListEvalRuns(ListEvalRunsRequest) ListEvalRunsResponse
  +DraftEvalCases(DraftEvalCasesRequest) DraftEvalCasesResponse
  +ListWorkflows(ListWorkflowsRequest) ListWorkflowsResponse
  +SaveWorkflow(SaveWorkflowRequest) SaveWorkflowResponse
  +DeleteWorkflow(DeleteWorkflowRequest) DeleteWorkflowResponse
  +ListWorkflowRuns(ListWorkflowRunsRequest) ListWorkflowRunsResponse
  +GetWorkflowRun(GetWorkflowRunRequest) GetWorkflowRunResponse
  +WatchWorkflowRun(WatchWorkflowRunRequest) Stream~WatchWorkflowRunResponse~
  +WatchWorkflowRuns(WatchWorkflowRunsRequest) Stream~WatchWorkflowRunsResponse~
  +StopWorkflowRun(StopWorkflowRunRequest) StopWorkflowRunResponse
  +GetWorkspaceHealth(GetWorkspaceHealthRequest) GetWorkspaceHealthResponse
  +WatchWorkspaceHealth(WatchWorkspaceHealthRequest) Stream~WatchWorkspaceHealthResponse~
  +EstimateHealthCheck(EstimateHealthCheckRequest) EstimateHealthCheckResponse
  +CheckWorkspaceHealth(CheckWorkspaceHealthRequest) Stream~CheckWorkspaceHealthResponse~
  +StopHealthCheck(StopHealthCheckRequest) StopHealthCheckResponse
  +StartHealthCheck(StartHealthCheckRequest) StartHealthCheckResponse
  +StartCompose(StartComposeRequest) StartComposeResponse
  +AnswerCompose(AnswerComposeRequest) AnswerComposeResponse
  +DropCompose(DropComposeRequest) DropComposeResponse
  +ListHumanTasks(ListHumanTasksRequest) ListHumanTasksResponse
  +WatchHumanTasks(WatchHumanTasksRequest) Stream~WatchHumanTasksResponse~
  +AnswerHumanTask(AnswerHumanTaskRequest) AnswerHumanTaskResponse
  +ListEnvs(ListEnvsRequest) ListEnvsResponse
  +RemoveEnv(RemoveEnvRequest) RemoveEnvResponse
  +PruneEnvs(PruneEnvsRequest) PruneEnvsResponse
  +DraftManifest(DraftManifestRequest) DraftManifestResponse
  +ListMCPServers(ListMCPServersRequest) ListMCPServersResponse
  +RestartMCPServer(RestartMCPServerRequest) RestartMCPServerResponse
  +ListTools(ListToolsRequest) ListToolsResponse
  +ReloadMemory(ReloadMemoryRequest) ReloadMemoryResponse
  +ReloadAgentFiles(ReloadAgentFilesRequest) ReloadAgentFilesResponse
  +AddMemory(AddMemoryRequest) AddMemoryResponse
  +ListLocales(ListLocalesRequest) ListLocalesResponse
  +SetLocale(SetLocaleRequest) SetLocaleResponse
  +ListCheckpoints(ListCheckpointsRequest) ListCheckpointsResponse
  +Undo(UndoRequest) UndoResponse
  +GetDiff(GetDiffRequest) GetDiffResponse
  +ListApprovals(ListApprovalsRequest) ListApprovalsResponse
  +RevokeApprovals(RevokeApprovalsRequest) RevokeApprovalsResponse
  +ListProcesses(ListProcessesRequest) ListProcessesResponse
  +GetProcessOutput(GetProcessOutputRequest) GetProcessOutputResponse
  +KillProcess(KillProcessRequest) KillProcessResponse
  +AuditShell(AuditShellRequest) AuditShellResponse
  +ListTasks(ListTasksRequest) ListTasksResponse
  +GetTask(GetTaskRequest) GetTaskResponse
  +StopTask(StopTaskRequest) StopTaskResponse
  +WatchTasks(WatchTasksRequest) Stream~WatchTasksResponse~
  +ListTaskRequests(ListTaskRequestsRequest) ListTaskRequestsResponse
  +GetProjectSettings(GetProjectSettingsRequest) GetProjectSettingsResponse
  +TrustProject(TrustProjectRequest) TrustProjectResponse
  +ForgetProjectTrust(ForgetProjectTrustRequest) ForgetProjectTrustResponse
  +TakeProcessNotices(TakeProcessNoticesRequest) TakeProcessNoticesResponse
  +ListStyles(ListStylesRequest) ListStylesResponse
  +ListHooks(ListHooksRequest) ListHooksResponse
  +ListNotes(ListNotesRequest) ListNotesResponse
  +ForgetNote(ForgetNoteRequest) ForgetNoteResponse
  +LoadImage(LoadImageRequest) LoadImageResponse
  +AddImage(AddImageRequest) AddImageResponse
  +GetSearchProvider(GetSearchProviderRequest) GetSearchProviderResponse
  +SearchWeb(SearchWebRequest) SearchWebResponse
  +SearchWorkspace(SearchWorkspaceRequest) SearchWorkspaceResponse
  +GetSearchStatus(GetSearchStatusRequest) GetSearchStatusResponse
  +Reindex(ReindexRequest) ReindexResponse
}
WorkspaceService --> `GetServiceInfoRequest`
WorkspaceService --> `GetServiceInfoResponse`
WorkspaceService --> `ShutdownRequest`
WorkspaceService --> `ShutdownResponse`
WorkspaceService --> `ListLogDaysRequest`
WorkspaceService --> `ListLogDaysResponse`
WorkspaceService --> `ReadLogRequest`
WorkspaceService --> `ReadLogResponse`
WorkspaceService --> `DeleteLogDayRequest`
WorkspaceService --> `DeleteLogDayResponse`
WorkspaceService --> `ListWorkspacesRequest`
WorkspaceService --> `ListWorkspacesResponse`
WorkspaceService --> `CloseWorkspaceRequest`
WorkspaceService --> `CloseWorkspaceResponse`
WorkspaceService --> `GetSandboxRequest`
WorkspaceService --> `GetSandboxResponse`
WorkspaceService --> `ListAgentsRequest`
WorkspaceService --> `ListAgentsResponse`
WorkspaceService --> `SetAgentRequest`
WorkspaceService --> `SetAgentResponse`
WorkspaceService --> `GetSuggestionsRequest`
WorkspaceService --> `GetSuggestionsResponse`
WorkspaceService --> `ListAgentFilesRequest`
WorkspaceService --> `ListAgentFilesResponse`
WorkspaceService --> `SaveAgentFileRequest`
WorkspaceService --> `SaveAgentFileResponse`
WorkspaceService --> `DeleteAgentFileRequest`
WorkspaceService --> `DeleteAgentFileResponse`
WorkspaceService --> `GetModelRequest`
WorkspaceService --> `GetModelResponse`
WorkspaceService --> `SetModelRequest`
WorkspaceService --> `SetModelResponse`
WorkspaceService --> `PinModelRequest`
WorkspaceService --> `PinModelResponse`
WorkspaceService --> `UnpinModelRequest`
WorkspaceService --> `UnpinModelResponse`
WorkspaceService --> `GetModelSettingsRequest`
WorkspaceService --> `GetModelSettingsResponse`
WorkspaceService --> `UpdateModelSettingsRequest`
WorkspaceService --> `UpdateModelSettingsResponse`
WorkspaceService --> `GetSettingsRequest`
WorkspaceService --> `GetSettingsResponse`
WorkspaceService --> `GetGitStatusRequest`
WorkspaceService --> `GetGitStatusResponse`
WorkspaceService --> `InitGitRepoRequest`
WorkspaceService --> `InitGitRepoResponse`
WorkspaceService --> `DraftCommitRequest`
WorkspaceService --> `DraftCommitResponse`
WorkspaceService --> `CommitRequest`
WorkspaceService --> `CommitResponse`
WorkspaceService --> `FetchRemoteRequest`
WorkspaceService --> `FetchRemoteResponse`
WorkspaceService --> `PullRequest`
WorkspaceService --> `PullResponse`
WorkspaceService --> `PushRequest`
WorkspaceService --> `PushResponse`
WorkspaceService --> `ResolveConflictRequest`
WorkspaceService --> `ResolveConflictResponse`
WorkspaceService --> `CompleteMergeRequest`
WorkspaceService --> `CompleteMergeResponse`
WorkspaceService --> `AbortMergeRequest`
WorkspaceService --> `AbortMergeResponse`
WorkspaceService --> `ListBranchesRequest`
WorkspaceService --> `ListBranchesResponse`
WorkspaceService --> `SwitchBranchRequest`
WorkspaceService --> `SwitchBranchResponse`
WorkspaceService --> `CreateBranchRequest`
WorkspaceService --> `CreateBranchResponse`
WorkspaceService --> `MergeBranchRequest`
WorkspaceService --> `MergeBranchResponse`
WorkspaceService --> `SetSettingRequest`
WorkspaceService --> `SetSettingResponse`
WorkspaceService --> `SetPermissionModeRequest`
WorkspaceService --> `SetPermissionModeResponse`
WorkspaceService --> `ListCommandsRequest`
WorkspaceService --> `ListCommandsResponse`
WorkspaceService --> `ListPermissionRulesRequest`
WorkspaceService --> `ListPermissionRulesResponse`
WorkspaceService --> `AddPermissionRuleRequest`
WorkspaceService --> `AddPermissionRuleResponse`
WorkspaceService --> `RemovePermissionRuleRequest`
WorkspaceService --> `RemovePermissionRuleResponse`
WorkspaceService --> `ListSkillsRequest`
WorkspaceService --> `ListSkillsResponse`
WorkspaceService --> `GetSkillRequest`
WorkspaceService --> `GetSkillResponse`
WorkspaceService --> `GetSkillFileRequest`
WorkspaceService --> `GetSkillFileResponse`
WorkspaceService --> `SaveSkillRequest`
WorkspaceService --> `SaveSkillResponse`
WorkspaceService --> `DeleteSkillRequest`
WorkspaceService --> `DeleteSkillResponse`
WorkspaceService --> `ReadSkillFileRequest`
WorkspaceService --> `ReadSkillFileResponse`
WorkspaceService --> `WriteSkillFileRequest`
WorkspaceService --> `WriteSkillFileResponse`
WorkspaceService --> `DeleteSkillFileRequest`
WorkspaceService --> `DeleteSkillFileResponse`
WorkspaceService --> `CopySkillRequest`
WorkspaceService --> `CopySkillResponse`
WorkspaceService --> `RunSkillScriptRequest`
WorkspaceService --> `RunSkillScriptResponse`
WorkspaceService --> `ListRulesRequest`
WorkspaceService --> `ListRulesResponse`
WorkspaceService --> `SaveRuleRequest`
WorkspaceService --> `SaveRuleResponse`
WorkspaceService --> `DeleteRuleRequest`
WorkspaceService --> `DeleteRuleResponse`
WorkspaceService --> `ReorderRulesRequest`
WorkspaceService --> `ReorderRulesResponse`
WorkspaceService --> `TryRuleRequest`
WorkspaceService --> `TryRuleResponse`
WorkspaceService --> `ListGuardrailsRequest`
WorkspaceService --> `ListGuardrailsResponse`
WorkspaceService --> `SaveGuardrailRequest`
WorkspaceService --> `SaveGuardrailResponse`
WorkspaceService --> `DeleteGuardrailRequest`
WorkspaceService --> `DeleteGuardrailResponse`
WorkspaceService --> `TryGuardrailRequest`
WorkspaceService --> `TryGuardrailResponse`
WorkspaceService --> `ListEvalsRequest`
WorkspaceService --> `ListEvalsResponse`
WorkspaceService --> `SaveEvalRequest`
WorkspaceService --> `SaveEvalResponse`
WorkspaceService --> `DeleteEvalRequest`
WorkspaceService --> `DeleteEvalResponse`
WorkspaceService --> `RunEvalRequest`
WorkspaceService --o `RunEvalResponse` : server stream
WorkspaceService --> `ListEvalRunsRequest`
WorkspaceService --> `ListEvalRunsResponse`
WorkspaceService --> `DraftEvalCasesRequest`
WorkspaceService --> `DraftEvalCasesResponse`
WorkspaceService --> `ListWorkflowsRequest`
WorkspaceService --> `ListWorkflowsResponse`
WorkspaceService --> `SaveWorkflowRequest`
WorkspaceService --> `SaveWorkflowResponse`
WorkspaceService --> `DeleteWorkflowRequest`
WorkspaceService --> `DeleteWorkflowResponse`
WorkspaceService --> `ListWorkflowRunsRequest`
WorkspaceService --> `ListWorkflowRunsResponse`
WorkspaceService --> `GetWorkflowRunRequest`
WorkspaceService --> `GetWorkflowRunResponse`
WorkspaceService --> `WatchWorkflowRunRequest`
WorkspaceService --o `WatchWorkflowRunResponse` : server stream
WorkspaceService --> `WatchWorkflowRunsRequest`
WorkspaceService --o `WatchWorkflowRunsResponse` : server stream
WorkspaceService --> `StopWorkflowRunRequest`
WorkspaceService --> `StopWorkflowRunResponse`
WorkspaceService --> `GetWorkspaceHealthRequest`
WorkspaceService --> `GetWorkspaceHealthResponse`
WorkspaceService --> `WatchWorkspaceHealthRequest`
WorkspaceService --o `WatchWorkspaceHealthResponse` : server stream
WorkspaceService --> `EstimateHealthCheckRequest`
WorkspaceService --> `EstimateHealthCheckResponse`
WorkspaceService --> `CheckWorkspaceHealthRequest`
WorkspaceService --o `CheckWorkspaceHealthResponse` : server stream
WorkspaceService --> `StopHealthCheckRequest`
WorkspaceService --> `StopHealthCheckResponse`
WorkspaceService --> `StartHealthCheckRequest`
WorkspaceService --> `StartHealthCheckResponse`
WorkspaceService --> `StartComposeRequest`
WorkspaceService --> `StartComposeResponse`
WorkspaceService --> `AnswerComposeRequest`
WorkspaceService --> `AnswerComposeResponse`
WorkspaceService --> `DropComposeRequest`
WorkspaceService --> `DropComposeResponse`
WorkspaceService --> `ListHumanTasksRequest`
WorkspaceService --> `ListHumanTasksResponse`
WorkspaceService --> `WatchHumanTasksRequest`
WorkspaceService --o `WatchHumanTasksResponse` : server stream
WorkspaceService --> `AnswerHumanTaskRequest`
WorkspaceService --> `AnswerHumanTaskResponse`
WorkspaceService --> `ListEnvsRequest`
WorkspaceService --> `ListEnvsResponse`
WorkspaceService --> `RemoveEnvRequest`
WorkspaceService --> `RemoveEnvResponse`
WorkspaceService --> `PruneEnvsRequest`
WorkspaceService --> `PruneEnvsResponse`
WorkspaceService --> `DraftManifestRequest`
WorkspaceService --> `DraftManifestResponse`
WorkspaceService --> `ListMCPServersRequest`
WorkspaceService --> `ListMCPServersResponse`
WorkspaceService --> `RestartMCPServerRequest`
WorkspaceService --> `RestartMCPServerResponse`
WorkspaceService --> `ListToolsRequest`
WorkspaceService --> `ListToolsResponse`
WorkspaceService --> `ReloadMemoryRequest`
WorkspaceService --> `ReloadMemoryResponse`
WorkspaceService --> `ReloadAgentFilesRequest`
WorkspaceService --> `ReloadAgentFilesResponse`
WorkspaceService --> `AddMemoryRequest`
WorkspaceService --> `AddMemoryResponse`
WorkspaceService --> `ListLocalesRequest`
WorkspaceService --> `ListLocalesResponse`
WorkspaceService --> `SetLocaleRequest`
WorkspaceService --> `SetLocaleResponse`
WorkspaceService --> `ListCheckpointsRequest`
WorkspaceService --> `ListCheckpointsResponse`
WorkspaceService --> `UndoRequest`
WorkspaceService --> `UndoResponse`
WorkspaceService --> `GetDiffRequest`
WorkspaceService --> `GetDiffResponse`
WorkspaceService --> `ListApprovalsRequest`
WorkspaceService --> `ListApprovalsResponse`
WorkspaceService --> `RevokeApprovalsRequest`
WorkspaceService --> `RevokeApprovalsResponse`
WorkspaceService --> `ListProcessesRequest`
WorkspaceService --> `ListProcessesResponse`
WorkspaceService --> `GetProcessOutputRequest`
WorkspaceService --> `GetProcessOutputResponse`
WorkspaceService --> `KillProcessRequest`
WorkspaceService --> `KillProcessResponse`
WorkspaceService --> `AuditShellRequest`
WorkspaceService --> `AuditShellResponse`
WorkspaceService --> `ListTasksRequest`
WorkspaceService --> `ListTasksResponse`
WorkspaceService --> `GetTaskRequest`
WorkspaceService --> `GetTaskResponse`
WorkspaceService --> `StopTaskRequest`
WorkspaceService --> `StopTaskResponse`
WorkspaceService --> `WatchTasksRequest`
WorkspaceService --o `WatchTasksResponse` : server stream
WorkspaceService --> `ListTaskRequestsRequest`
WorkspaceService --> `ListTaskRequestsResponse`
WorkspaceService --> `GetProjectSettingsRequest`
WorkspaceService --> `GetProjectSettingsResponse`
WorkspaceService --> `TrustProjectRequest`
WorkspaceService --> `TrustProjectResponse`
WorkspaceService --> `ForgetProjectTrustRequest`
WorkspaceService --> `ForgetProjectTrustResponse`
WorkspaceService --> `TakeProcessNoticesRequest`
WorkspaceService --> `TakeProcessNoticesResponse`
WorkspaceService --> `ListStylesRequest`
WorkspaceService --> `ListStylesResponse`
WorkspaceService --> `ListHooksRequest`
WorkspaceService --> `ListHooksResponse`
WorkspaceService --> `ListNotesRequest`
WorkspaceService --> `ListNotesResponse`
WorkspaceService --> `ForgetNoteRequest`
WorkspaceService --> `ForgetNoteResponse`
WorkspaceService --> `LoadImageRequest`
WorkspaceService --> `LoadImageResponse`
WorkspaceService --> `AddImageRequest`
WorkspaceService --> `AddImageResponse`
WorkspaceService --> `GetSearchProviderRequest`
WorkspaceService --> `GetSearchProviderResponse`
WorkspaceService --> `SearchWebRequest`
WorkspaceService --> `SearchWebResponse`
WorkspaceService --> `SearchWorkspaceRequest`
WorkspaceService --> `SearchWorkspaceResponse`
WorkspaceService --> `GetSearchStatusRequest`
WorkspaceService --> `GetSearchStatusResponse`
WorkspaceService --> `ReindexRequest`
WorkspaceService --> `ReindexResponse`

classDiagram
direction LR
%% SuggestionKind is what a welcome tile does. The state kinds carry data for the front end to word in its own language; IDEA carries text.

class SuggestionKind{
  <<enumeration>>
  SUGGESTION_KIND_UNSPECIFIED
  SUGGESTION_KIND_SETUP
  SUGGESTION_KIND_CONTINUE
  SUGGESTION_KIND_CHANGES
  SUGGESTION_KIND_WORKER_FAILED
  SUGGESTION_KIND_IDEA
  SUGGESTION_KIND_HARNESS_UPDATE
}

classDiagram
direction LR
%% AgentScope is where an agent's file is kept.

class AgentScope{
  <<enumeration>>
  AGENT_SCOPE_UNSPECIFIED
  AGENT_SCOPE_WORKSPACE
  AGENT_SCOPE_USER
}

classDiagram
direction LR
%% What a repository is in the middle of.

class GitOperation{
  <<enumeration>>
  GIT_OPERATION_UNSPECIFIED
  GIT_OPERATION_MERGE
  GIT_OPERATION_REBASE
}

classDiagram
direction LR
%% How a pull went.

class PullOutcome{
  <<enumeration>>
  PULL_OUTCOME_UNSPECIFIED
  PULL_OUTCOME_UP_TO_DATE
  PULL_OUTCOME_FAST_FORWARD
  PULL_OUTCOME_MERGED
  PULL_OUTCOME_REBASED
  PULL_OUTCOME_CONFLICTS
}

classDiagram
direction LR
%% How a conflicted file is settled.

class ConflictChoice{
  <<enumeration>>
  CONFLICT_CHOICE_UNSPECIFIED
  CONFLICT_CHOICE_MINE
  CONFLICT_CHOICE_THEIRS
  CONFLICT_CHOICE_RESOLVED
}

classDiagram
direction LR

%% Saved reports where a change was written in the config file. The change applies even when saving fails.

class Saved {
  + string path
  + string error
}

classDiagram
direction LR

%% Request message for WorkspaceService.Shutdown.

class ShutdownRequest {
}

classDiagram
direction LR

%% Response message for WorkspaceService.Shutdown: sent before the service stops.

class ShutdownResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.GetServiceInfo.

class GetServiceInfoRequest {
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetServiceInfo.

class GetServiceInfoResponse {
  + string version
  + string executable
  + google.protobuf.Timestamp started
  + int32 pid
  + bool replaced
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListLogDays.

class ListLogDaysRequest {
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListLogDays.

class ListLogDaysResponse {
  + List~string~ days
  + string dir
}

classDiagram
direction LR

%% Request message for WorkspaceService.ReadLog.

class ReadLogRequest {
  + string day
  + string min_level
  + string text
  + int32 limit
}

classDiagram
direction LR

%% A field of a log record.

class LogAttr {
  + string key
  + string value
}

classDiagram
direction LR

%% A log record.

class LogEntry {
  + google.protobuf.Timestamp time
  + string level
  + string message
  + List~LogAttr~ attrs
}
LogEntry --> `LogAttr`

classDiagram
direction LR

%% Response message for WorkspaceService.ReadLog.

class ReadLogResponse {
  + string day
  + string path
  + List~LogEntry~ entries
  + int32 matched
}
ReadLogResponse --> `LogEntry`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteLogDay.

class DeleteLogDayRequest {
  + string day
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteLogDay.

class DeleteLogDayResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListWorkspaces.

class ListWorkspacesRequest {
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListWorkspaces.

class ListWorkspacesResponse {
  + List~string~ workspaces
}

classDiagram
direction LR

%% Request message for WorkspaceService.CloseWorkspace.

class CloseWorkspaceRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.CloseWorkspace.

class CloseWorkspaceResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.GetSandbox.

class GetSandboxRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSandbox.

class GetSandboxResponse {
  + List~string~ summary
}

classDiagram
direction LR

%% AgentInfo describes an agent.

class AgentInfo {
  + string name
  + string display_name
  + string description
  + bool active
  + string pinned_model
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListAgents.

class ListAgentsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListAgents.

class ListAgentsResponse {
  + List~AgentInfo~ agents
}
ListAgentsResponse --> `AgentInfo`

classDiagram
direction LR

%% Request message for WorkspaceService.SetAgent.

class SetAgentRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.SetAgent.

class SetAgentResponse {
  + AgentInfo agent
}
SetAgentResponse --> `AgentInfo`

classDiagram
direction LR

%% Suggestion is one welcome tile.

class Suggestion {
  + SuggestionKind kind
  + string title
  + string prompt
  + string session_id
  + string worker
  + int32 count
  + string detail
}
Suggestion --> `SuggestionKind`

classDiagram
direction LR

%% Request message for WorkspaceService.GetSuggestions.

class GetSuggestionsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSuggestions.

class GetSuggestionsResponse {
  + List~Suggestion~ suggestions
  + bool harness_missing
  + bool pending
}
GetSuggestionsResponse --> `Suggestion`

classDiagram
direction LR

%% AgentDefinition is an agent's file: its frontmatter and its prompt.

class AgentDefinition {
  + string name
  + string display_name
  + string description
  + List~string~ tools
  + string default_model
  + string agency_level
  + string permission_mode
  + int32 max_turns
  + bool background
  + string isolation
  + Optional~double~ temperature
  + Optional~double~ top_p
  + Optional~int32~ max_tokens
  + string effort
  + Optional~int32~ thinking_budget
  + string prompt
}

classDiagram
direction LR

%% AgentFile is one agent file of a scope.

class AgentFile {
  + string path
  + AgentDefinition agent
  + string problem
}
AgentFile --> `AgentDefinition`

classDiagram
direction LR

%% Request message for WorkspaceService.ListAgentFiles.

class ListAgentFilesRequest {
  + string workspace
  + AgentScope scope
}
ListAgentFilesRequest --> `AgentScope`

classDiagram
direction LR

%% Response message for WorkspaceService.ListAgentFiles.

class ListAgentFilesResponse {
  + List~AgentFile~ files
  + string dir
}
ListAgentFilesResponse --> `AgentFile`

classDiagram
direction LR

%% Request message for WorkspaceService.SaveAgentFile.

class SaveAgentFileRequest {
  + string workspace
  + AgentScope scope
  + string previous_name
  + AgentDefinition agent
}
SaveAgentFileRequest --> `AgentScope`
SaveAgentFileRequest --> `AgentDefinition`

classDiagram
direction LR

%% Response message for WorkspaceService.SaveAgentFile.

class SaveAgentFileResponse {
  + AgentFile file
  + List~string~ problems
}
SaveAgentFileResponse --> `AgentFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteAgentFile.

class DeleteAgentFileRequest {
  + string workspace
  + AgentScope scope
  + string name
  + string path
}
DeleteAgentFileRequest --> `AgentScope`

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteAgentFile.

class DeleteAgentFileResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.GetModel.

class GetModelRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetModel.

class GetModelResponse {
  + string name
  + string provider
  + string unavailable
}

classDiagram
direction LR

%% Request message for WorkspaceService.SetModel.

class SetModelRequest {
  + string workspace
  + string ref
}

classDiagram
direction LR

%% Response message for WorkspaceService.SetModel.

class SetModelResponse {
  + string active_pin
}

classDiagram
direction LR

%% Request message for WorkspaceService.PinModel.

class PinModelRequest {
  + string workspace
  + string agent
  + string ref
}

classDiagram
direction LR

%% Response message for WorkspaceService.PinModel.

class PinModelResponse {
  + string agent
  + string model
  + Saved saved
}
PinModelResponse --> `Saved`

classDiagram
direction LR

%% Request message for WorkspaceService.UnpinModel.

class UnpinModelRequest {
  + string workspace
  + string agent
}

classDiagram
direction LR

%% Response message for WorkspaceService.UnpinModel.

class UnpinModelResponse {
  + string agent
  + string model
  + Saved saved
}
UnpinModelResponse --> `Saved`

classDiagram
direction LR

%% ModelSettings are a model's generation settings; unset fields use the global value or the provider's default.

class ModelSettings {
  + Optional~double~ temperature
  + Optional~int32~ max_tokens
  + Optional~double~ top_p
  + Optional~int32~ seed
  + Optional~string~ reasoning_effort
  + Optional~int32~ thinking_budget
}

classDiagram
direction LR

%% ModelSettingsInfo is one model's settings and what applies otherwise.

class ModelSettingsInfo {
  + string model
  + string provider
  + ModelSettings settings
  + double global_temperature
  + int32 global_max_tokens
}
ModelSettingsInfo --> `ModelSettings`

classDiagram
direction LR

%% Request message for WorkspaceService.GetModelSettings.

class GetModelSettingsRequest {
  + string workspace
  + string ref
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetModelSettings.

class GetModelSettingsResponse {
  + Map~string,  ModelSettings~ all
  + ModelSettingsInfo model
}
GetModelSettingsResponse .. ` ModelSettings`
GetModelSettingsResponse --> `ModelSettingsInfo`

classDiagram
direction LR

%% Setting is one key=value change; an empty value clears the key.

class Setting {
  + string key
  + string value
}

classDiagram
direction LR

%% Request message for WorkspaceService.UpdateModelSettings.

class UpdateModelSettingsRequest {
  + string workspace
  + string ref
  + bool reset
  + List~Setting~ changes
}
UpdateModelSettingsRequest --> `Setting`

classDiagram
direction LR

%% Response message for WorkspaceService.UpdateModelSettings.

class UpdateModelSettingsResponse {
  + ModelSettingsInfo model
  + List~string~ unsupported
  + Saved saved
}
UpdateModelSettingsResponse --> `ModelSettingsInfo`
UpdateModelSettingsResponse --> `Saved`

classDiagram
direction LR

%% Request message for WorkspaceService.GetSettings.

class GetSettingsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSettings.

class GetSettingsResponse {
  + string agency
  + string model
  + string provider
  + string agent
  + string locale
  + bool images_enabled
  + string permission_mode
  + string effort
  + string style
  + string speech_model
  + string speech_error
  + List~AcceptedMedia~ accepted_media
}
GetSettingsResponse --> `AcceptedMedia`

classDiagram
direction LR

%% AcceptedMedia is a kind of attachment a model takes.

class AcceptedMedia {
  + string kind
  + List~string~ mime_types
  + List~string~ extensions
  + int64 max_bytes
}

classDiagram
direction LR

%% Request message for WorkspaceService.SetPermissionMode.

class SetPermissionModeRequest {
  + string workspace
  + string mode
}

classDiagram
direction LR

%% Response message for WorkspaceService.SetPermissionMode.

class SetPermissionModeResponse {
  + string mode
}

classDiagram
direction LR

%% Command is a custom slash command.

class Command {
  + string name
  + string description
  + string argument_hint
  + string source
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListCommands.

class ListCommandsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListCommands.

class ListCommandsResponse {
  + List~Command~ commands
}
ListCommandsResponse --> `Command`

classDiagram
direction LR

%% PermissionRule is an allow, ask or deny rule.

class PermissionRule {
  + string effect
  + string rule
  + string source
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListPermissionRules.

class ListPermissionRulesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListPermissionRules.

class ListPermissionRulesResponse {
  + List~PermissionRule~ rules
  + string problem
}
ListPermissionRulesResponse --> `PermissionRule`

classDiagram
direction LR

%% Request message for WorkspaceService.AddPermissionRule.

class AddPermissionRuleRequest {
  + string workspace
  + string effect
  + string rule
  + bool save
  + string scope
}

classDiagram
direction LR

%% Response message for WorkspaceService.AddPermissionRule.

class AddPermissionRuleResponse {
  + string rule
  + bool next_start
  + Saved saved
}
AddPermissionRuleResponse --> `Saved`

classDiagram
direction LR

%% Request message for WorkspaceService.RemovePermissionRule.

class RemovePermissionRuleRequest {
  + string workspace
  + string rule
  + bool save
  + string scope
}

classDiagram
direction LR

%% Response message for WorkspaceService.RemovePermissionRule.

class RemovePermissionRuleResponse {
  + string rule
  + int32 removed
  + Saved saved
}
RemovePermissionRuleResponse --> `Saved`

classDiagram
direction LR

%% Request message for WorkspaceService.SetSetting.

class SetSettingRequest {
  + string workspace
  + string key
  + string value
}

classDiagram
direction LR

%% Response message for WorkspaceService.SetSetting.

class SetSettingResponse {
  + string key
}

classDiagram
direction LR

%% SkillInfo describes a skill and what the skills policy lets it do.

class SkillInfo {
  + string name
  + string description
  + string version
  + string license
  + string category
  + string compatibility
  + List~string~ tags
  + string hash
  + List~SkillTool~ tools
  + List~SkillScript~ scripts
  + string tier
  + bool bypass
  + bool network
  + bool needs_network
  + List~string~ env
  + List~string~ withheld
  + List~string~ blocked
  + string dir
  + string kind
  + List~string~ agents
  + List~string~ members
  + List~string~ references
  + bool project
  + List~string~ package_files
  + bool needs_review
}
SkillInfo --> `SkillTool`
SkillInfo --> `SkillScript`

classDiagram
direction LR

%% SkillTool is a tool a skill needs.

class SkillTool {
  + string name
  + List~string~ scopes
  + string why
}

classDiagram
direction LR

%% SkillScript is one of a skill's scripts and the policy's verdict.

class SkillScript {
  + string name
  + string language
  + string source
  + google.protobuf.Duration timeout
  + List~string~ deps
  + bool allowed
  + List~string~ reasons
  + bool found
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListSkills.

class ListSkillsRequest {
  + string workspace
  + string query
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListSkills.

class ListSkillsResponse {
  + List~SkillInfo~ skills
}
ListSkillsResponse --> `SkillInfo`

classDiagram
direction LR

%% Request message for WorkspaceService.GetSkill.

class GetSkillRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSkill.

class GetSkillResponse {
  + SkillInfo skill
}
GetSkillResponse --> `SkillInfo`

classDiagram
direction LR

%% What Studio's skill form edits.

class SkillSpec {
  + string name
  + string description
  + string tools
  + List~string~ agents
  + List~string~ members
  + string instructions
}

classDiagram
direction LR

%% A skill as Studio edits it.

class SkillFile {
  + SkillInfo skill
  + string path
  + string hash
  + SkillSpec spec
  + bool editable
}
SkillFile --> `SkillInfo`
SkillFile --> `SkillSpec`

classDiagram
direction LR

%% Request message for WorkspaceService.GetSkillFile.

class GetSkillFileRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSkillFile.

class GetSkillFileResponse {
  + SkillFile file
}
GetSkillFileResponse --> `SkillFile`

classDiagram
direction LR

%% Request message for WorkspaceService.SaveSkill.

class SaveSkillRequest {
  + string workspace
  + string previous_name
  + string hash
  + SkillSpec skill
}
SaveSkillRequest --> `SkillSpec`

classDiagram
direction LR

%% Response message for WorkspaceService.SaveSkill.

class SaveSkillResponse {
  + SkillFile file
  + List~string~ problems
}
SaveSkillResponse --> `SkillFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteSkill.

class DeleteSkillRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteSkill.

class DeleteSkillResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.ReadSkillFile.

class ReadSkillFileRequest {
  + string workspace
  + string name
  + string path
}

classDiagram
direction LR

%% Response message for WorkspaceService.ReadSkillFile.

class ReadSkillFileResponse {
  + bytes content
}

classDiagram
direction LR

%% Request message for WorkspaceService.WriteSkillFile.

class WriteSkillFileRequest {
  + string workspace
  + string name
  + string path
  + bytes content
}

classDiagram
direction LR

%% Response message for WorkspaceService.WriteSkillFile.

class WriteSkillFileResponse {
  + SkillFile file
}
WriteSkillFileResponse --> `SkillFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteSkillFile.

class DeleteSkillFileRequest {
  + string workspace
  + string name
  + string path
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteSkillFile.

class DeleteSkillFileResponse {
  + SkillFile file
}
DeleteSkillFileResponse --> `SkillFile`

classDiagram
direction LR

%% Request message for WorkspaceService.CopySkill.

class CopySkillRequest {
  + string workspace
  + string from
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.CopySkill.

class CopySkillResponse {
  + SkillFile file
  + List~string~ problems
}
CopySkillResponse --> `SkillFile`

classDiagram
direction LR

%% Request message for WorkspaceService.RunSkillScript.

class RunSkillScriptRequest {
  + string workspace
  + string name
  + string script
  + List~string~ args
}

classDiagram
direction LR

%% Response message for WorkspaceService.RunSkillScript.

class RunSkillScriptResponse {
  + int32 exit_code
  + string stdout
  + string stderr
  + bool timed_out
  + string sandbox
  + List~string~ output_files
  + string error
}

classDiagram
direction LR

%% Env is an isolated Python environment built for skill scripts.

class Env {
  + string key
  + List~string~ deps
  + List~string~ skills
  + int64 size
  + google.protobuf.Timestamp last_used
  + bool ready
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListEnvs.

class ListEnvsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListEnvs.

class ListEnvsResponse {
  + List~Env~ envs
}
ListEnvsResponse --> `Env`

classDiagram
direction LR

%% Request message for WorkspaceService.RemoveEnv.

class RemoveEnvRequest {
  + string workspace
  + string key
}

classDiagram
direction LR

%% Response message for WorkspaceService.RemoveEnv.

class RemoveEnvResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.PruneEnvs.

class PruneEnvsRequest {
  + string workspace
}

classDiagram
direction LR

%% EnvError is an environment that couldn't be removed.

class EnvError {
  + string key
  + string error
}

classDiagram
direction LR

%% Response message for WorkspaceService.PruneEnvs.

class PruneEnvsResponse {
  + int32 removed
  + int64 freed
  + List~EnvError~ failed
}
PruneEnvsResponse --> `EnvError`

classDiagram
direction LR

%% MCPServer is a configured MCP server.

class MCPServer {
  + string name
  + string target
  + bool auto_approve
  + bool disabled
  + string state
  + string error
  + int32 tools
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListMCPServers.

class ListMCPServersRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListMCPServers.

class ListMCPServersResponse {
  + List~MCPServer~ servers
}
ListMCPServersResponse --> `MCPServer`

classDiagram
direction LR

%% Request message for WorkspaceService.RestartMCPServer.

class RestartMCPServerRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.RestartMCPServer.

class RestartMCPServerResponse {
}

classDiagram
direction LR

%% ToolInfo is a tool an agent can call.

class ToolInfo {
  + string name
  + string description
  + bool plan_allowed
}

classDiagram
direction LR

%% MCPOffer is an MCP server offered to an agent.

class MCPOffer {
  + string server
  + List~string~ tools
  + string prefix
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListTools.

class ListToolsRequest {
  + string workspace
  + bool all
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListTools.

class ListToolsResponse {
  + string agent
  + List~ToolInfo~ tools
  + List~MCPOffer~ mcp
}
ListToolsResponse --> `ToolInfo`
ListToolsResponse --> `MCPOffer`

classDiagram
direction LR

%% Request message for WorkspaceService.ReloadMemory.

class ReloadMemoryRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ReloadMemory.

class ReloadMemoryResponse {
  + List~string~ paths
  + List~string~ files
}

classDiagram
direction LR

%% Request message for WorkspaceService.ReloadAgentFiles.

class ReloadAgentFilesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ReloadAgentFiles.

class ReloadAgentFilesResponse {
  + int32 agents
  + int32 skills
  + List~string~ files
  + List~string~ problems
}

classDiagram
direction LR

%% Request message for WorkspaceService.AddMemory.

class AddMemoryRequest {
  + string workspace
  + string text
}

classDiagram
direction LR

%% Response message for WorkspaceService.AddMemory.

class AddMemoryResponse {
  + string path
}

classDiagram
direction LR

%% LocaleInfo names a language with an interface catalog.

class LocaleInfo {
  + string tag
  + string name
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListLocales.

class ListLocalesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListLocales.

class ListLocalesResponse {
  + List~LocaleInfo~ locales
  + string custom_dir
}
ListLocalesResponse --> `LocaleInfo`

classDiagram
direction LR

%% Request message for WorkspaceService.SetLocale.

class SetLocaleRequest {
  + string workspace
  + string input
}

classDiagram
direction LR

%% Response message for WorkspaceService.SetLocale.

class SetLocaleResponse {
  + string tag
  + string native_name
  + string language_name
  + bool has_catalog
  + Saved saved
}
SetLocaleResponse --> `Saved`

classDiagram
direction LR

%% Checkpoint is the files one turn changed.

class Checkpoint {
  + int32 id
  + string label
  + google.protobuf.Timestamp time
  + List~string~ files
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListCheckpoints.

class ListCheckpointsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListCheckpoints.

class ListCheckpointsResponse {
  + List~Checkpoint~ checkpoints
}
ListCheckpointsResponse --> `Checkpoint`

classDiagram
direction LR

%% Request message for WorkspaceService.Undo.

class UndoRequest {
  + string workspace
  + bool force
}

classDiagram
direction LR

%% Response message for WorkspaceService.Undo.

class UndoResponse {
  + string label
  + List~string~ restored
  + ErrorInfo error
}
UndoResponse --> `ErrorInfo`

classDiagram
direction LR

%% Request message for WorkspaceService.GetDiff.

class GetDiffRequest {
  + string workspace
  + bool git
  + bool color
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetDiff.

class GetDiffResponse {
  + string diff
}

classDiagram
direction LR

%% Approval is a standing permission.

class Approval {
  + string key
  + string kind
  + string subject
  + string dir
  + bool always
  + google.protobuf.Timestamp added
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListApprovals.

class ListApprovalsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListApprovals.

class ListApprovalsResponse {
  + List~Approval~ approvals
}
ListApprovalsResponse --> `Approval`

classDiagram
direction LR

%% Request message for WorkspaceService.RevokeApprovals.

class RevokeApprovalsRequest {
  + string workspace
  + List~string~ keys
  + bool all
}

classDiagram
direction LR

%% Response message for WorkspaceService.RevokeApprovals.

class RevokeApprovalsResponse {
  + int32 revoked
  + ErrorInfo error
}
RevokeApprovalsResponse --> `ErrorInfo`

classDiagram
direction LR

%% Process is a background process the agent started, and how it is.

class Process {
  + int32 id
  + string command
  + bool running
  + int32 exit_code
  + int64 runtime_ms
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListProcesses.

class ListProcessesRequest {
  + string workspace
  + List~string~ session_ids
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListProcesses.

class ListProcessesResponse {
  + List~Process~ processes
}
ListProcessesResponse --> `Process`

classDiagram
direction LR

%% Request message for WorkspaceService.GetProcessOutput.

class GetProcessOutputRequest {
  + string workspace
  + List~string~ session_ids
  + int32 id
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetProcessOutput.

class GetProcessOutputResponse {
  + string output
  + Process process
}
GetProcessOutputResponse --> `Process`

classDiagram
direction LR

%% Request message for WorkspaceService.KillProcess.

class KillProcessRequest {
  + string workspace
  + List~string~ session_ids
  + int32 id
}

classDiagram
direction LR

%% Response message for WorkspaceService.KillProcess.

class KillProcessResponse {
  + Process process
}
KillProcessResponse --> `Process`

classDiagram
direction LR

%% Request message for WorkspaceService.AuditShell.

class AuditShellRequest {
  + string workspace
  + string command
  + int32 exit_code
  + string start_error
}

classDiagram
direction LR

%% Response message for WorkspaceService.AuditShell.

class AuditShellResponse {
}

classDiagram
direction LR

%% BackgroundTask is a sub-agent running beside the turn that started it.

class BackgroundTask {
  + string id
  + string agent
  + string prompt
  + string session_id
  + string state
  + google.protobuf.Timestamp started
  + google.protobuf.Timestamp ended
  + string result
  + string error
  + Usage usage
  + string worktree
  + string branch
}
BackgroundTask --> `Usage`

classDiagram
direction LR

%% Request message for WorkspaceService.ListTasks.

class ListTasksRequest {
  + string workspace
  + List~string~ session_ids
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListTasks.

class ListTasksResponse {
  + List~BackgroundTask~ tasks
}
ListTasksResponse --> `BackgroundTask`

classDiagram
direction LR

%% Request message for WorkspaceService.GetTask.

class GetTaskRequest {
  + string workspace
  + List~string~ session_ids
  + string id
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetTask.

class GetTaskResponse {
  + BackgroundTask task
  + List~string~ events
}
GetTaskResponse --> `BackgroundTask`

classDiagram
direction LR

%% Request message for WorkspaceService.StopTask.

class StopTaskRequest {
  + string workspace
  + List~string~ session_ids
  + string id
}

classDiagram
direction LR

%% TaskEvent is something that happened to a background task outside a turn.

class TaskEvent {
  + Oneof~BackgroundTask~ task [oneof: kind]
  + Oneof~ApprovalRequest~ approval_request [oneof: kind]
  + Oneof~Question~ question [oneof: kind]
  + Oneof~string~ resolved [oneof: kind]
  + Oneof~bool~ ready [oneof: kind]
  + Oneof~bool~ settings_changed [oneof: kind]
}
TaskEvent --> `BackgroundTask`
TaskEvent --> `ApprovalRequest`
TaskEvent --> `Question`

classDiagram
direction LR

%% Request message for WorkspaceService.WatchTasks.

class WatchTasksRequest {
  + string workspace
  + List~string~ session_ids
}

classDiagram
direction LR

%% Response message for WorkspaceService.WatchTasks.

class WatchTasksResponse {
  + TaskEvent event
}
WatchTasksResponse --> `TaskEvent`

classDiagram
direction LR

%% Request message for WorkspaceService.ListTaskRequests.

class ListTaskRequestsRequest {
  + string workspace
  + List~string~ session_ids
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListTaskRequests.

class ListTaskRequestsResponse {
  + List~TaskEvent~ requests
}
ListTaskRequestsResponse --> `TaskEvent`

classDiagram
direction LR

%% Response message for WorkspaceService.StopTask.

class StopTaskResponse {
  + BackgroundTask task
}
StopTaskResponse --> `BackgroundTask`

classDiagram
direction LR

%% ProjectItem is one setting from a project file.

class ProjectItem {
  + string file
  + string kind
  + string key
  + string value
  + string reason
}

classDiagram
direction LR

%% ProjectSettings are what a workspace's project files say.

class ProjectSettings {
  + List~string~ files
  + string state
  + string hash
  + bool loaded
  + List~ProjectItem~ applied
  + List~ProjectItem~ pending
  + List~ProjectItem~ ignored
  + List~string~ problems
}
ProjectSettings --> `ProjectItem`
ProjectSettings --> `ProjectItem`
ProjectSettings --> `ProjectItem`

classDiagram
direction LR

%% Request message for WorkspaceService.GetProjectSettings.

class GetProjectSettingsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetProjectSettings.

class GetProjectSettingsResponse {
  + ProjectSettings settings
}
GetProjectSettingsResponse --> `ProjectSettings`

classDiagram
direction LR

%% Request message for WorkspaceService.TakeProcessNotices.

class TakeProcessNoticesRequest {
  + string workspace
  + string session_id
}

classDiagram
direction LR

%% Response message for WorkspaceService.TakeProcessNotices.

class TakeProcessNoticesResponse {
  + List~string~ notices
}

classDiagram
direction LR

%% Style is an output style.

class Style {
  + string name
  + string description
  + string source
  + bool active
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListStyles.

class ListStylesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListStyles.

class ListStylesResponse {
  + List~Style~ styles
}
ListStylesResponse --> `Style`

classDiagram
direction LR

%% Hook is a configured hook.

class Hook {
  + string event
  + string type
  + string match
  + string if
  + string runs
  + string source
  + bool fail_closed
  + List~HookFailure~ failures
}
Hook --> `HookFailure`

classDiagram
direction LR

%% HookFailure is one failed run of a hook.

class HookFailure {
  + google.protobuf.Timestamp time
  + string error
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListHooks.

class ListHooksRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListHooks.

class ListHooksResponse {
  + List~Hook~ hooks
}
ListHooksResponse --> `Hook`

classDiagram
direction LR

%% Note is something the agent remembered across sessions of a workspace.

class Note {
  + string name
  + string kind
  + string text
  + google.protobuf.Timestamp time
  + string path
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListNotes.

class ListNotesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListNotes.

class ListNotesResponse {
  + List~Note~ notes
}
ListNotesResponse --> `Note`

classDiagram
direction LR

%% Request message for WorkspaceService.ForgetNote.

class ForgetNoteRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.ForgetNote.

class ForgetNoteResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.ForgetProjectTrust.

class ForgetProjectTrustRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ForgetProjectTrust.

class ForgetProjectTrustResponse {
  + bool reopened
}

classDiagram
direction LR

%% Request message for WorkspaceService.TrustProject.

class TrustProjectRequest {
  + string workspace
  + string hash
  + bool trusted
}

classDiagram
direction LR

%% Response message for WorkspaceService.TrustProject.

class TrustProjectResponse {
  + bool reopened
}

classDiagram
direction LR

%% Image is an image or a PDF stored for a prompt.

class Image {
  + string id
  + string name
  + string mime_type
  + int32 width
  + int32 height
  + int64 size
  + bool resized
  + int32 pages
  + string kind
  + double seconds
}

classDiagram
direction LR

%% Request message for WorkspaceService.LoadImage.

class LoadImageRequest {
  + string workspace
  + string path
}

classDiagram
direction LR

%% Response message for WorkspaceService.LoadImage.

class LoadImageResponse {
  + Image image
}
LoadImageResponse --> `Image`

classDiagram
direction LR

%% Request message for WorkspaceService.AddImage.

class AddImageRequest {
  + string workspace
  + string name
  + bytes data
}

classDiagram
direction LR

%% Response message for WorkspaceService.AddImage.

class AddImageResponse {
  + Image image
}
AddImageResponse --> `Image`

classDiagram
direction LR

%% Link is a search result handed to the agent.

class Link {
  + string title
  + string url
}

classDiagram
direction LR

%% Request message for WorkspaceService.GetSearchProvider.

class GetSearchProviderRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSearchProvider.

class GetSearchProviderResponse {
  + string provider
}

classDiagram
direction LR

%% Request message for WorkspaceService.SearchWeb.

class SearchWebRequest {
  + string workspace
  + string terms
}

classDiagram
direction LR

%% Response message for WorkspaceService.SearchWeb.

class SearchWebResponse {
  + string provider
  + List~Link~ links
  + string prompt
}
SearchWebResponse --> `Link`

classDiagram
direction LR

%% Request message for WorkspaceService.SearchWorkspace.

class SearchWorkspaceRequest {
  + string workspace
  + string query
  + List~string~ sources
  + int32 limit
  + string mode
  + bool hidden
}

classDiagram
direction LR

%% SearchHit is one item workspace search found.

class SearchHit {
  + string source
  + string ref
  + string title
  + int32 line
  + string section
  + string snippet
  + double score
  + string summary
  + List~string~ tags
}

classDiagram
direction LR

%% Response message for WorkspaceService.SearchWorkspace.

class SearchWorkspaceResponse {
  + List~SearchHit~ hits
  + List~string~ sources
}
SearchWorkspaceResponse --> `SearchHit`

classDiagram
direction LR

%% Request message for WorkspaceService.GetSearchStatus.

class GetSearchStatusRequest {
  + string workspace
}

classDiagram
direction LR

%% SearchStatus is how a workspace's search index is.

class SearchStatus {
  + bool enabled
  + Map~string,  int32~ items
  + bool scanning
  + google.protobuf.Timestamp last_scan
  + int32 unreadable
  + string error
  + string embedding_model
  + int32 embedded
  + string embed_error
  + int32 enriched
  + string enrich_error
  + SearchSettings settings
  + string problem
}
SearchStatus --> `SearchSettings`

classDiagram
direction LR

%% SearchSettings are a workspace's [search] settings (set with ConfigService.SetConfigValue: search.enabled, search.sources, …).

class SearchSettings {
  + bool enabled
  + List~string~ sources
  + string embedding_model
  + bool enrich
  + string enrich_model
  + int32 enrich_daily_limit
  + bool include_ignored
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetSearchStatus.

class GetSearchStatusResponse {
  + SearchStatus status
}
GetSearchStatusResponse --> `SearchStatus`

classDiagram
direction LR

%% Request message for WorkspaceService.Reindex.

class ReindexRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.Reindex.

class ReindexResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.GetGitStatus.

class GetGitStatusRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetGitStatus.

class GetGitStatusResponse {
  + bool repo
  + string branch
  + int32 changed
  + bool git
  + bool remote
  + string upstream
  + int32 ahead
  + int32 behind
  + GitOperation operation
  + List~string~ conflicts
  + string merging
}
GetGitStatusResponse --> `GitOperation`

classDiagram
direction LR

%% Request message for WorkspaceService.InitGitRepo.

class InitGitRepoRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.InitGitRepo.

class InitGitRepoResponse {
  + GetGitStatusResponse status
}
InitGitRepoResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% A file in the index, for the commit dialog.

class StagedFile {
  + string status
  + string path
}

classDiagram
direction LR

%% Request message for WorkspaceService.DraftCommit.

class DraftCommitRequest {
  + string workspace
  + bool stage_all
}

classDiagram
direction LR

%% Response message for WorkspaceService.DraftCommit.

class DraftCommitResponse {
  + List~StagedFile~ files
  + string message
  + string problem
}
DraftCommitResponse --> `StagedFile`

classDiagram
direction LR

%% Request message for WorkspaceService.Commit.

class CommitRequest {
  + string workspace
  + string message
}

classDiagram
direction LR

%% Response message for WorkspaceService.Commit.

class CommitResponse {
  + string hash
  + string subject
}

classDiagram
direction LR

%% Request message for WorkspaceService.FetchRemote.

class FetchRemoteRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.FetchRemote.

class FetchRemoteResponse {
  + GetGitStatusResponse status
}
FetchRemoteResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.Pull.

class PullRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.Pull.

class PullResponse {
  + PullOutcome outcome
  + int32 commits
  + GetGitStatusResponse status
}
PullResponse --> `PullOutcome`
PullResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.Push.

class PushRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.Push.

class PushResponse {
  + string target
  + GetGitStatusResponse status
}
PushResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.ResolveConflict.

class ResolveConflictRequest {
  + string workspace
  + string path
  + ConflictChoice choice
}
ResolveConflictRequest --> `ConflictChoice`

classDiagram
direction LR

%% Response message for WorkspaceService.ResolveConflict.

class ResolveConflictResponse {
  + GetGitStatusResponse status
}
ResolveConflictResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.CompleteMerge.

class CompleteMergeRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.CompleteMerge.

class CompleteMergeResponse {
  + GetGitStatusResponse status
}
CompleteMergeResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.AbortMerge.

class AbortMergeRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.AbortMerge.

class AbortMergeResponse {
  + GetGitStatusResponse status
}
AbortMergeResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% A branch the workspace can switch to or merge.

class Branch {
  + string name
  + bool remote
  + bool current
  + string upstream
  + string subject
  + google.protobuf.Timestamp time
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListBranches.

class ListBranchesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListBranches.

class ListBranchesResponse {
  + List~Branch~ branches
}
ListBranchesResponse --> `Branch`

classDiagram
direction LR

%% Request message for WorkspaceService.SwitchBranch.

class SwitchBranchRequest {
  + string workspace
  + string branch
}

classDiagram
direction LR

%% Response message for WorkspaceService.SwitchBranch.

class SwitchBranchResponse {
  + GetGitStatusResponse status
}
SwitchBranchResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.CreateBranch.

class CreateBranchRequest {
  + string workspace
  + string branch
}

classDiagram
direction LR

%% Response message for WorkspaceService.CreateBranch.

class CreateBranchResponse {
  + GetGitStatusResponse status
}
CreateBranchResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.MergeBranch.

class MergeBranchRequest {
  + string workspace
  + string branch
}

classDiagram
direction LR

%% Response message for WorkspaceService.MergeBranch.

class MergeBranchResponse {
  + PullOutcome outcome
  + int32 commits
  + GetGitStatusResponse status
}
MergeBranchResponse --> `PullOutcome`
MergeBranchResponse --> `GetGitStatusResponse`

classDiagram
direction LR

%% Request message for WorkspaceService.DraftManifest.

class DraftManifestRequest {
  + string workspace
  + string kind
  + string name
  + string description
  + string current
  + string request
  + string language
}

classDiagram
direction LR

%% Response message for WorkspaceService.DraftManifest.

class DraftManifestResponse {
  + string text
  + List~string~ changes
  + string problem
}

classDiagram
direction LR

%% A rule file: a gate (when set) or an instruction rule.

class RuleFile {
  + string name
  + string path
  + string when
  + string action
  + int32 order
  + List~string~ agents
  + string description
  + List~string~ paths
  + string text
  + string problem
  + bool editable
}

classDiagram
direction LR

%% What Studio's rule form edits.

class RuleSpec {
  + string name
  + string when
  + string action
  + int32 order
  + List~string~ agents
  + string description
  + List~string~ paths
  + string text
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListRules.

class ListRulesRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListRules.

class ListRulesResponse {
  + List~RuleFile~ rules
  + string dir
}
ListRulesResponse --> `RuleFile`

classDiagram
direction LR

%% Request message for WorkspaceService.SaveRule.

class SaveRuleRequest {
  + string workspace
  + string previous_name
  + RuleSpec rule
}
SaveRuleRequest --> `RuleSpec`

classDiagram
direction LR

%% Response message for WorkspaceService.SaveRule.

class SaveRuleResponse {
  + RuleFile rule
  + List~string~ problems
}
SaveRuleResponse --> `RuleFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteRule.

class DeleteRuleRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteRule.

class DeleteRuleResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.ReorderRules.

class ReorderRulesRequest {
  + string workspace
  + List~string~ names
}

classDiagram
direction LR

%% Response message for WorkspaceService.ReorderRules.

class ReorderRulesResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.TryRule.

class TryRuleRequest {
  + string workspace
  + RuleSpec rule
  + string sample
}
TryRuleRequest --> `RuleSpec`

classDiagram
direction LR

%% Response message for WorkspaceService.TryRule.

class TryRuleResponse {
  + bool pass
  + string reason
  + string problem
}

classDiagram
direction LR

%% The limits guardrail's limits; zero or empty means none of that kind.

class GuardrailLimits {
  + double max_cost_usd
  + int32 max_turns
  + int32 max_files_changed
  + List~string~ allowed_domains
  + List~string~ commands
}

classDiagram
direction LR

%% A guardrail file, or a built-in guardrail without one (its defaults).

class GuardrailFile {
  + string name
  + string path
  + string builtin
  + string stage
  + string action
  + List~string~ agents
  + List~string~ tools
  + string description
  + bool pii
  + bool judge
  + GuardrailLimits limits
  + string text
  + string problem
  + bool editable
  + bool off
}
GuardrailFile --> `GuardrailLimits`

classDiagram
direction LR

%% A built-in guardrail: on by default.

class BuiltinGuardrail {
  + string id
  + string stage
  + string default_action
  + List~string~ actions
  + GuardrailFile file
}
BuiltinGuardrail --> `GuardrailFile`

classDiagram
direction LR

%% What Studio's guardrail form edits.

class GuardrailSpec {
  + string name
  + string builtin
  + string stage
  + string action
  + List~string~ agents
  + List~string~ tools
  + string description
  + bool pii
  + bool judge
  + GuardrailLimits limits
  + string text
  + bool off
}
GuardrailSpec --> `GuardrailLimits`

classDiagram
direction LR

%% Request message for WorkspaceService.ListGuardrails.

class ListGuardrailsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListGuardrails.

class ListGuardrailsResponse {
  + List~BuiltinGuardrail~ builtins
  + List~GuardrailFile~ guardrails
  + string dir
}
ListGuardrailsResponse --> `BuiltinGuardrail`
ListGuardrailsResponse --> `GuardrailFile`

classDiagram
direction LR

%% Request message for WorkspaceService.SaveGuardrail.

class SaveGuardrailRequest {
  + string workspace
  + string previous_name
  + GuardrailSpec guardrail
}
SaveGuardrailRequest --> `GuardrailSpec`

classDiagram
direction LR

%% Response message for WorkspaceService.SaveGuardrail.

class SaveGuardrailResponse {
  + GuardrailFile guardrail
  + List~string~ problems
}
SaveGuardrailResponse --> `GuardrailFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteGuardrail.

class DeleteGuardrailRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteGuardrail.

class DeleteGuardrailResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.TryGuardrail.

class TryGuardrailRequest {
  + string workspace
  + GuardrailSpec guardrail
  + string sample
}
TryGuardrailRequest --> `GuardrailSpec`

classDiagram
direction LR

%% Response message for WorkspaceService.TryGuardrail.

class TryGuardrailResponse {
  + bool pass
  + string reason
  + string problem
}

classDiagram
direction LR

%% A row of an eval's table.

class EvalCase {
  + string id
  + string name
  + string prompt
  + string output
  + string type
  + double threshold
  + string scope
}

classDiagram
direction LR

%% An eval file in .agents/evals.

class EvalFile {
  + string name
  + string path
  + string description
  + List~string~ agents
  + List~string~ skills
  + string near
  + List~string~ allow
  + List~EvalCase~ cases
  + string problem
  + EvalRun last_run
}
EvalFile --> `EvalCase`
EvalFile --> `EvalRun`

classDiagram
direction LR

%% What Studio's eval form edits.

class EvalSpec {
  + string name
  + string description
  + List~string~ agents
  + List~string~ skills
  + string near
  + List~string~ allow
  + List~EvalCase~ cases
}
EvalSpec --> `EvalCase`

classDiagram
direction LR

%% One case run by one agent, and its score.

class EvalResult {
  + string case
  + string name
  + string agent
  + string type
  + string scope
  + string status
  + double score
  + double threshold
  + string prompt
  + string expected
  + string output
  + string reason
  + List~string~ refusals
  + double cost_usd
  + google.protobuf.Duration duration
}

classDiagram
direction LR

%% A run of an eval.

class EvalRun {
  + string id
  + string eval
  + google.protobuf.Timestamp started
  + google.protobuf.Duration duration
  + string status
  + List~EvalResult~ results
  + double cost_usd
  + string error
  + Map~string,  int32~ counts
}
EvalRun --> `EvalResult`

classDiagram
direction LR

%% Request message for WorkspaceService.ListEvals.

class ListEvalsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListEvals.

class ListEvalsResponse {
  + List~EvalFile~ evals
  + string dir
}
ListEvalsResponse --> `EvalFile`

classDiagram
direction LR

%% Request message for WorkspaceService.SaveEval.

class SaveEvalRequest {
  + string workspace
  + string previous_name
  + EvalSpec eval
}
SaveEvalRequest --> `EvalSpec`

classDiagram
direction LR

%% Response message for WorkspaceService.SaveEval.

class SaveEvalResponse {
  + EvalFile eval
  + List~string~ problems
}
SaveEvalResponse --> `EvalFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteEval.

class DeleteEvalRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteEval.

class DeleteEvalResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.RunEval.

class RunEvalRequest {
  + string workspace
  + string name
  + List~string~ cases
}

classDiagram
direction LR

%% Response message for WorkspaceService.RunEval: the run as it starts, each result, then the finished run.

class RunEvalResponse {
  + Oneof~EvalRun~ started [oneof: event]
  + Oneof~EvalResult~ result [oneof: event]
  + Oneof~EvalRun~ finished [oneof: event]
}
RunEvalResponse --> `EvalRun`
RunEvalResponse --> `EvalResult`
RunEvalResponse --> `EvalRun`

classDiagram
direction LR

%% Request message for WorkspaceService.ListEvalRuns.

class ListEvalRunsRequest {
  + string workspace
  + string name
  + int32 limit
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListEvalRuns.

class ListEvalRunsResponse {
  + List~EvalRun~ runs
}
ListEvalRunsResponse --> `EvalRun`

classDiagram
direction LR

%% Request message for WorkspaceService.DraftEvalCases.

class DraftEvalCasesRequest {
  + string workspace
  + string agent
  + string request
  + List~EvalCase~ existing
}
DraftEvalCasesRequest --> `EvalCase`

classDiagram
direction LR

%% Response message for WorkspaceService.DraftEvalCases.

class DraftEvalCasesResponse {
  + List~EvalCase~ cases
  + string problem
}
DraftEvalCasesResponse --> `EvalCase`

classDiagram
direction LR

%% A workflow's step.

class FlowNode {
  + string id
  + string type
  + string title
  + double x
  + double y
  + string agent
  + List~string~ skills
  + string instructions
  + List~string~ rules
  + string skill
  + string script
  + List~string~ args
  + string path
  + List~FlowField~ fields
  + int32 retry_attempts
  + string retry_delay
  + string timeout
  + string server
  + string tool
  + string arguments_json
  + string url
  + string method
  + List~FlowPair~ query
  + List~FlowPair~ headers
  + string body
  + string json_body
  + FlowAuth auth
  + string workflow
  + string for_each
  + int32 concurrency
  + string form_json
  + string wait
  + string until
}
FlowNode --> `FlowField`
FlowNode --> `FlowPair`
FlowNode --> `FlowPair`
FlowNode --> `FlowAuth`

classDiagram
direction LR

%% A paused workflow run's task: a human task's form waiting for an answer, or a timer waiting for its time.

class HumanTask {
  + string id
  + string run
  + string workspace
  + string workflow
  + string step
  + string title
  + string kind
  + string message
  + string a2ui_json
  + google.protobuf.Timestamp fire_at
  + google.protobuf.Timestamp created
  + string session_id
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListHumanTasks.

class ListHumanTasksRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListHumanTasks.

class ListHumanTasksResponse {
  + List~HumanTask~ tasks
  + string alerts
}
ListHumanTasksResponse --> `HumanTask`

classDiagram
direction LR

%% Request message for WorkspaceService.WatchHumanTasks.

class WatchHumanTasksRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.WatchHumanTasks: the tasks now (each message the whole list).

class WatchHumanTasksResponse {
  + List~HumanTask~ tasks
  + string alerts
}
WatchHumanTasksResponse --> `HumanTask`

classDiagram
direction LR

%% Request message for WorkspaceService.AnswerHumanTask.

class AnswerHumanTaskRequest {
  + string workspace
  + string task_id
  + string action_json
  + string data_json
}

classDiagram
direction LR

%% Response message for WorkspaceService.AnswerHumanTask.

class AnswerHumanTaskResponse {
  + BackgroundRun run
}
AnswerHumanTaskResponse --> `BackgroundRun`

classDiagram
direction LR

%% A named value: a header, a query parameter.

class FlowPair {
  + string name
  + string value
}

classDiagram
direction LR

%% How an API call authenticates.

class FlowAuth {
  + string type
  + string token
  + string username
  + string password
  + string name
  + string value
  + string in
  + string token_url
  + string client_id
  + string client_secret
  + List~string~ scopes
  + string audience
}

classDiagram
direction LR

%% A value an extract step pulls out.

class FlowField {
  + string name
  + string type
  + string description
}

classDiagram
direction LR

%% A link carrying a step's output to another.

class FlowEdge {
  + string from
  + string to
  + string when
  + string if
  + bool default
  + bool error
  + string label
}

classDiagram
direction LR

%% A workflow file in .agents/workflows.

class WorkflowFile {
  + string name
  + string path
  + string description
  + List~FlowNode~ nodes
  + List~FlowEdge~ edges
  + string problem
  + string mode
}
WorkflowFile --> `FlowNode`
WorkflowFile --> `FlowEdge`

classDiagram
direction LR

%% Request message for WorkspaceService.ListWorkflows.

class ListWorkflowsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListWorkflows.

class ListWorkflowsResponse {
  + List~WorkflowFile~ workflows
  + string dir
}
ListWorkflowsResponse --> `WorkflowFile`

classDiagram
direction LR

%% Request message for WorkspaceService.SaveWorkflow.

class SaveWorkflowRequest {
  + string workspace
  + string previous_name
  + WorkflowFile workflow
}
SaveWorkflowRequest --> `WorkflowFile`

classDiagram
direction LR

%% Response message for WorkspaceService.SaveWorkflow.

class SaveWorkflowResponse {
  + WorkflowFile workflow
  + List~string~ problems
}
SaveWorkflowResponse --> `WorkflowFile`

classDiagram
direction LR

%% Request message for WorkspaceService.DeleteWorkflow.

class DeleteWorkflowRequest {
  + string workspace
  + string name
}

classDiagram
direction LR

%% Response message for WorkspaceService.DeleteWorkflow.

class DeleteWorkflowResponse {
}

classDiagram
direction LR

%% A workflow run's receipt (spec_workflows_043 WF-19): its envelope (what started it, when, on what) and routing slip (each step's run, in the order they ran), with what it spent.

class WorkflowRun {
  + string id
  + string workspace
  + string workflow
  + string origin
  + string session_id
  + string input
  + google.protobuf.Timestamp started
  + google.protobuf.Timestamp ended
  + string status
  + string error
  + string output
  + Usage usage
  + List~string~ models
  + List~WorkflowRunStep~ steps
  + List~WorkflowRunEvent~ events
  + string background_id
  + int32 approvals
  + string mode
}
WorkflowRun --> `Usage`
WorkflowRun --> `WorkflowRunStep`
WorkflowRun --> `WorkflowRunEvent`

classDiagram
direction LR

%% One run of a workflow's step.

class WorkflowRunStep {
  + string id
  + string title
  + string type
  + string status
  + google.protobuf.Timestamp started
  + google.protobuf.Timestamp ended
  + int32 attempts
  + string agent
  + List~string~ models
  + Usage usage
  + string output
  + string stream
  + string error
}
WorkflowRunStep --> `Usage`

classDiagram
direction LR

%% Something that happened in a workflow run.

class WorkflowRunEvent {
  + google.protobuf.Timestamp at
  + string step
  + string kind
  + string text
  + bool error
}

classDiagram
direction LR

%% Request message for WorkspaceService.ListWorkflowRuns.

class ListWorkflowRunsRequest {
  + string workspace
  + string workflow
  + int32 limit
}

classDiagram
direction LR

%% Response message for WorkspaceService.ListWorkflowRuns.

class ListWorkflowRunsResponse {
  + List~WorkflowRun~ runs
}
ListWorkflowRunsResponse --> `WorkflowRun`

classDiagram
direction LR

%% Request message for WorkspaceService.GetWorkflowRun.

class GetWorkflowRunRequest {
  + string workspace
  + string id
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetWorkflowRun.

class GetWorkflowRunResponse {
  + WorkflowRun run
}
GetWorkflowRunResponse --> `WorkflowRun`

classDiagram
direction LR

%% Request message for WorkspaceService.WatchWorkflowRun.

class WatchWorkflowRunRequest {
  + string workspace
  + string id
}

classDiagram
direction LR

%% Response message for WorkspaceService.WatchWorkflowRun.

class WatchWorkflowRunResponse {
  + WorkflowRun run
}
WatchWorkflowRunResponse --> `WorkflowRun`

classDiagram
direction LR

%% Request message for WorkspaceService.WatchWorkflowRuns.

class WatchWorkflowRunsRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.WatchWorkflowRuns.

class WatchWorkflowRunsResponse {
  + List~WorkflowRun~ runs
}
WatchWorkflowRunsResponse --> `WorkflowRun`

classDiagram
direction LR

%% Request message for WorkspaceService.StopWorkflowRun.

class StopWorkflowRunRequest {
  + string workspace
  + string id
}

classDiagram
direction LR

%% Response message for WorkspaceService.StopWorkflowRun.

class StopWorkflowRunResponse {
}

classDiagram
direction LR

%% A workspace's dashboard (spec_health_044).

class WorkspaceHealth {
  + google.protobuf.Timestamp at
  + List~HealthItem~ items
  + List~HealthDay~ days
  + List~HealthSignal~ signals
  + double overall
  + Map~string,  double~ by_kind
  + double previous_overall
  + google.protobuf.Timestamp last_check
  + double last_cost_usd
  + string skipped
  + string model
  + string schedule
  + google.protobuf.Timestamp next
  + double max_cost_usd
  + bool checking
  + HealthCheckProgress progress
  + int32 last_judged
  + List~string~ last_errors
}
WorkspaceHealth --> `HealthItem`
WorkspaceHealth --> `HealthDay`
WorkspaceHealth --> `HealthSignal`
WorkspaceHealth --> `HealthCheckProgress`

classDiagram
direction LR

%% How far a check going is.

class HealthCheckProgress {
  + string item
  + int32 index
  + int32 total
  + double cost_usd
}

classDiagram
direction LR

%% One agent, skill, rule, guardrail, eval, workflow or worker.

class HealthItem {
  + string kind
  + string name
  + string path
  + string detail
  + string problem
  + List~string~ flags
  + int32 uses
  + int32 fired
  + HealthRuns runs
  + HealthEvals evals
  + List~int32~ daily
  + HealthVerdict verdict
  + List~double~ history
}
HealthItem --> `HealthRuns`
HealthItem --> `HealthEvals`
HealthItem --> `HealthVerdict`

classDiagram
direction LR

%% A workflow's or a worker's runs in the last 30 days.

class HealthRuns {
  + int32 runs
  + int32 done
  + int32 failed
  + int32 stopped
  + double cost_usd
  + int64 median_ms
  + google.protobuf.Timestamp last
  + string failing_step
}

classDiagram
direction LR

%% An agent's or an eval's latest eval results.

class HealthEvals {
  + int32 runs
  + google.protobuf.Timestamp last
  + int32 passed
  + int32 cases
}

classDiagram
direction LR

%% The judge's verdict on an item.

class HealthVerdict {
  + string model
  + google.protobuf.Timestamp at
  + List~HealthScore~ scores
  + double overall
  + string grade
  + string summary
  + List~string~ fixes
  + double cost_usd
  + bool current
}
HealthVerdict --> `HealthScore`

classDiagram
direction LR

%% One rubric line's score.

class HealthScore {
  + string line
  + int32 score
  + string reason
}

classDiagram
direction LR

%% One day's runs.

class HealthDay {
  + string date
  + int32 done
  + int32 failed
  + int32 stopped
  + double cost_usd
}

classDiagram
direction LR

%% A safety signal: the reviewer's denials, a rule's or a guardrail's decisions, by what they were about.

class HealthSignal {
  + string kind
  + string about
  + int32 count
  + google.protobuf.Timestamp last
  + string detail
}

classDiagram
direction LR

%% Request message for WorkspaceService.GetWorkspaceHealth.

class GetWorkspaceHealthRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.GetWorkspaceHealth.

class GetWorkspaceHealthResponse {
  + WorkspaceHealth health
}
GetWorkspaceHealthResponse --> `WorkspaceHealth`

classDiagram
direction LR

%% Request message for WorkspaceService.WatchWorkspaceHealth.

class WatchWorkspaceHealthRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.WatchWorkspaceHealth.

class WatchWorkspaceHealthResponse {
  + WorkspaceHealth health
}
WatchWorkspaceHealthResponse --> `WorkspaceHealth`

classDiagram
direction LR

%% Which items a check judges: kinds, items ("kind/name"), or all; force re-judges unchanged ones.

class HealthCheckScope {
  + List~string~ kinds
  + List~string~ items
  + bool force
}

classDiagram
direction LR

%% Request message for WorkspaceService.EstimateHealthCheck.

class EstimateHealthCheckRequest {
  + string workspace
  + HealthCheckScope scope
}
EstimateHealthCheckRequest --> `HealthCheckScope`

classDiagram
direction LR

%% Response message for WorkspaceService.EstimateHealthCheck.

class EstimateHealthCheckResponse {
  + int32 items
  + double cost_usd
  + bool priced
}

classDiagram
direction LR

%% Request message for WorkspaceService.CheckWorkspaceHealth.

class CheckWorkspaceHealthRequest {
  + string workspace
  + HealthCheckScope scope
}
CheckWorkspaceHealthRequest --> `HealthCheckScope`

classDiagram
direction LR

%% Response message for WorkspaceService.CheckWorkspaceHealth: one item's verdict (or why it has none), then a last one with done.

class CheckWorkspaceHealthResponse {
  + string item
  + int32 index
  + int32 total
  + HealthVerdict verdict
  + string error
  + double cost_usd
  + bool done
  + int32 judged
}
CheckWorkspaceHealthResponse --> `HealthVerdict`

classDiagram
direction LR

%% Request message for WorkspaceService.StopHealthCheck.

class StopHealthCheckRequest {
  + string workspace
}

classDiagram
direction LR

%% Response message for WorkspaceService.StopHealthCheck.

class StopHealthCheckResponse {
}

classDiagram
direction LR

%% Request message for WorkspaceService.StartHealthCheck.

class StartHealthCheckRequest {
  + string workspace
  + HealthCheckScope scope
}
StartHealthCheckRequest --> `HealthCheckScope`

classDiagram
direction LR

%% Response message for WorkspaceService.StartHealthCheck.

class StartHealthCheckResponse {
}

classDiagram
direction LR

%% A composer conversation as it is.

class ComposeSession {
  + string id
  + string kind
  + List~ComposeTurn~ turns
  + bool asking
  + ComposeDraft draft
  + double cost_usd
}
ComposeSession --> `ComposeTurn`
ComposeSession --> `ComposeDraft`

classDiagram
direction LR

%% One message of a composer conversation: the user's, or the composer's (a question with its suggested answers, or a draft's summary).

class ComposeTurn {
  + string role
  + string text
  + List~string~ options
}

classDiagram
direction LR

%% A component the composer wrote: its name, a summary, its file, what the kind's checks still find wrong, and for a workflow the workflow itself.

class ComposeDraft {
  + string name
  + string summary
  + string file
  + List~string~ problems
  + WorkflowFile workflow
}
ComposeDraft --> `WorkflowFile`

classDiagram
direction LR

%% Request message for WorkspaceService.StartCompose.

class StartComposeRequest {
  + string workspace
  + string kind
  + string request
  + string current
}

classDiagram
direction LR

%% Response message for WorkspaceService.StartCompose.

class StartComposeResponse {
  + ComposeSession session
}
StartComposeResponse --> `ComposeSession`

classDiagram
direction LR

%% Request message for WorkspaceService.AnswerCompose.

class AnswerComposeRequest {
  + string workspace
  + string id
  + string answer
}

classDiagram
direction LR

%% Response message for WorkspaceService.AnswerCompose.

class AnswerComposeResponse {
  + ComposeSession session
}
AnswerComposeResponse --> `ComposeSession`

classDiagram
direction LR

%% Request message for WorkspaceService.DropCompose.

class DropComposeRequest {
  + string workspace
  + string id
}

classDiagram
direction LR

%% Response message for WorkspaceService.DropCompose.

class DropComposeResponse {
}