<!-- CODE GENERATED BY cmd/harbor-gen-protocol-docs. DO NOT EDIT. -->

Protocol wire types

The 224 canonical Harbor Protocol wire types, generated from the single-source inventory (internal/protocol/singlesource.CanonicalWireTypes) by reflection over the declaring packages. Field order is wire order; the Wire key column is the JSON key a client reads and writes. The Protocol version is 0.1.0 (RFC §5.3 — bumping it is an RFC change with a deprecation window).

Unknown-field tolerance: clients SHOULD ignore response fields they do not know (additive evolution is non-breaking); the Runtime rejects unknown REQUEST fields on the surfaces that decode strictly, so send only what a type declares.

Agent

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
name	string
description	string
incarnation	int64
version_hash	string
owner	string
status	types.AgentStatus
health	types.AgentHealth
hosting	types.AgentHosting
planner_type	string
model	string
tools_count	int
mcp_count	int
registered_at	string
updated_at	string

AgentAggregates

Declared in internal/protocol/types.

Wire key	Go type	Notes
total	int64
active	int64
paused	int64
drained	int64

AgentConfig

Declared in internal/protocol/types.

Wire key	Go type	Notes
planner_type	string
planner_config	map[string]string	optional (omitempty)
model	string
model_policy	map[string]string	optional (omitempty)
max_steps	int

AgentControlRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string
reason	string	optional (omitempty)

AgentControlResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent_id	string
command	string
status	types.AgentStatus

AgentCostCeiling

Declared in internal/protocol/types.

Wire key	Go type	Notes
tier	string
limit_usd	float64
spend_usd	float64

AgentFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
status	[]types.AgentStatus	optional (omitempty)
planner_type	[]string	optional (omitempty)
search	string	optional (omitempty)

AgentGetRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

AgentGetResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent	types.Agent — see Agent
config	types.AgentConfig — see AgentConfig
agent_card_ref	string	optional (omitempty)

AgentGovernance

Declared in internal/protocol/types.

Wire key	Go type	Notes
ceilings	[]types.AgentCostCeiling — see AgentCostCeiling
rate_limits	[]types.AgentRateLimit — see AgentRateLimit

AgentGovernanceRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

AgentGovernanceResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent_id	string
governance	types.AgentGovernance — see AgentGovernance

AgentListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.AgentFilter — see AgentFilter	optional (omitempty)
page	int	optional (omitempty)
page_size	int	optional (omitempty)

AgentListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agents	[]types.Agent — see Agent
page	int
page_size	int
page_count	int
total_rows	int64
aggregates	types.AgentAggregates — see AgentAggregates

AgentMemoryBinding

Declared in internal/protocol/types.

Wire key	Go type	Notes
strategy_id	string
ttl_seconds	int64
scope	string

AgentMemoryRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

AgentMemoryResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent_id	string
binding	types.AgentMemoryBinding — see AgentMemoryBinding

AgentMetrics

Declared in internal/protocol/types.

Wire key	Go type	Notes
active_agents	int64
running_tasks	int64
total_cost_usd	float64
total_tokens	int64

AgentMetricsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope

AgentMetricsResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
metrics	types.AgentMetrics — see AgentMetrics

AgentPermissions

Declared in internal/protocol/types.

Wire key	Go type	Notes
model	string
description	string
allowed_principals	[]string	optional (omitempty)

AgentPermissionsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

AgentPermissionsResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent_id	string
permissions	types.AgentPermissions — see AgentPermissions

AgentRateLimit

Declared in internal/protocol/types.

Wire key	Go type	Notes
tier	string
requests_per_minute	int64
max_tokens	int64

AgentSkillBinding

Declared in internal/protocol/types.

Wire key	Go type	Notes
skill_id	string
name	string
generated	bool

AgentSkillsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

AgentSkillsResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent_id	string
skills	[]types.AgentSkillBinding — see AgentSkillBinding

AgentToolBinding

Declared in internal/protocol/types.

Wire key	Go type	Notes
tool_id	string
tool_name	string
transport	string
auth_status	string
binding_scope	string	optional (omitempty)

AgentToolsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

AgentToolsResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
agent_id	string
bindings	[]types.AgentToolBinding — see AgentToolBinding

ArtifactRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
mime_type	string	optional (omitempty)
size_bytes	int64
filename	string	optional (omitempty)
sha256	string	optional (omitempty)
namespace	string	optional (omitempty)
scope	types.ArtifactScope — see ArtifactScope

ArtifactRefSummary

Declared in internal/protocol/types.

Wire key	Go type	Notes
filename	string
mime	string
size_bytes	int64
created_at	time.Time

ArtifactRow

Declared in internal/protocol/types.

Wire key	Go type	Notes
ref	types.ArtifactRef — see ArtifactRef
tags	[]string	optional (omitempty)
source	types.ArtifactSource	optional (omitempty)
driver	string	optional (omitempty)
created_at	time.Time	optional (omitempty)

ArtifactScope

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenant	string
user	string
session	string
task	string	optional (omitempty)

ArtifactsDeleteRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
scope	types.ArtifactScope — see ArtifactScope
id	string

ArtifactsDeleteResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
deleted	bool
protocol_version	string

ArtifactsGetRefRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
scope	types.ArtifactScope — see ArtifactScope
id	string
expiry	time.Duration	optional (omitempty)

ArtifactsGetRefResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
ref	types.ArtifactRef — see ArtifactRef
presigned_url	string
expires_at	time.Time
protocol_version	string

ArtifactsListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
scope	types.ArtifactScope — see ArtifactScope
mime_type	[]string	optional (omitempty)
source	[]types.ArtifactSource	optional (omitempty)
size_range	*types.SizeRange — see SizeRange	optional (omitempty)
created_range	*types.TimeRange — see TimeRange	optional (omitempty)
tags	[]string	optional (omitempty)
limit	int	optional (omitempty)

ArtifactsListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
rows	[]types.ArtifactRow — see ArtifactRow
total_matched	int
protocol_version	string

ArtifactsPutOpts

Declared in internal/protocol/types.

Wire key	Go type	Notes
mime_type	string	optional (omitempty)
filename	string	optional (omitempty)
namespace	string	optional (omitempty)
source	types.ArtifactSource	optional (omitempty)
tags	[]string	optional (omitempty)

ArtifactsPutRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
scope	types.ArtifactScope — see ArtifactScope
bytes	[]uint8
opts	types.ArtifactsPutOpts — see ArtifactsPutOpts	optional (omitempty)

ArtifactsPutResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
ref	types.ArtifactRef — see ArtifactRef
protocol_version	string

AuthRotateTokenRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope

AuthRotateTokenResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
new_token	string
expires_at	time.Time

ControlRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
payload	map[string]any	optional (omitempty)
event_id	string	optional (omitempty)

ControlResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
accepted	bool
method	string
protocol_version	string

Deprecation

Declared in internal/protocol/types.

Wire key	Go type	Notes
subject	string
kind	types.DeprecationKind
deprecated_in	string
removed_in	string
replacement	string	optional (omitempty)
note	string	optional (omitempty)

Error

Declared in internal/protocol/errors.

Wire key	Go type	Notes
code	errors.Code
message	string

EventAggregateRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope	optional (omitempty)
filter	types.EventFilter — see EventFilter
window	time.Duration
bucket	time.Duration

EventAggregateResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
buckets	[]types.EventBucket — see EventBucket
protocol_version	string

EventBucket

Declared in internal/protocol/types.

Wire key	Go type	Notes
bucket_start	time.Time
bucket_end	time.Time
counts	map[string]int64

EventFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
event_types	[]string	optional (omitempty)
tenant_ids	[]string	optional (omitempty)
user_ids	[]string	optional (omitempty)
session_ids	[]string	optional (omitempty)
run_ids	[]string	optional (omitempty)
since	time.Time	optional (omitempty)
until	time.Time	optional (omitempty)

Flow

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
name	string
owner	string	optional (omitempty)
version	string	optional (omitempty)
planner_family	string	optional (omitempty)
node_count	int
edge_count	int
runs_24h	int64
p50_latency_ms	int64
p95_latency_ms	int64
success_rate	float64
last_run	time.Time	optional (omitempty)
budget	types.FlowBudget — see FlowBudget

FlowArtifactRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
mime_type	string	optional (omitempty)
size_bytes	int64	optional (omitempty)
filename	string	optional (omitempty)
sha256	string	optional (omitempty)

FlowBudget

Declared in internal/protocol/types.

Wire key	Go type	Notes
deadline_ms	int64	optional (omitempty)
request_cap	int	optional (omitempty)
cost_cap_usd	float64	optional (omitempty)
token_cap	int64	optional (omitempty)

FlowBudgetConsumption

Declared in internal/protocol/types.

Wire key	Go type	Notes
requests_used	int
cost_usd_used	float64
tokens_used	int64

FlowDescribeRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

FlowDescription

Declared in internal/protocol/types.

Wire key	Go type	Notes
flow	types.Flow — see Flow
nodes	[]types.FlowNode — see FlowNode
edges	[]types.FlowEdge — see FlowEdge
source	string	optional (omitempty)
budget_consumption	types.FlowBudgetConsumption — see FlowBudgetConsumption

FlowEdge

Declared in internal/protocol/types.

Wire key	Go type	Notes
from	string
to	string

FlowFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenants	[]string	optional (omitempty)
planner_families	[]string	optional (omitempty)
query	string	optional (omitempty)

FlowListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.FlowFilter — see FlowFilter
page	int	optional (omitempty)
page_size	int	optional (omitempty)

FlowListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
flows	[]types.Flow — see Flow
page	int
page_size	int
page_count	int
total_rows	int

FlowMetrics

Declared in internal/protocol/types.

Wire key	Go type	Notes
flow_id	string
window_start	time.Time
window_end	time.Time
buckets	[]types.FlowMetricsBucket — see FlowMetricsBucket
budget_consumption	types.FlowBudgetConsumption — see FlowBudgetConsumption

FlowMetricsBucket

Declared in internal/protocol/types.

Wire key	Go type	Notes
bucket_start	time.Time
runs	int64
p95_latency_ms	int64
success_rate	float64
cost_usd	float64

FlowMetricsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
flow_id	string
window_ms	int64	optional (omitempty)
bucket_ms	int64	optional (omitempty)

FlowNode

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
type	types.FlowNodeKind
descriptor	string	optional (omitempty)
policy	*types.FlowNodePolicy — see FlowNodePolicy	optional (omitempty)

FlowNodePolicy

Declared in internal/protocol/types.

Wire key	Go type	Notes
max_retries	int	optional (omitempty)
timeout_ms	int64	optional (omitempty)

FlowNodeRunState

Declared in internal/protocol/types.

Wire key	Go type	Notes
node_id	string
status	types.FlowRunStatus
duration_ms	int64	optional (omitempty)
retries	int	optional (omitempty)
error_class	string	optional (omitempty)

FlowRun

Declared in internal/protocol/types.

Wire key	Go type	Notes
run_id	string
flow_id	string
status	types.FlowRunStatus
trigger	types.FlowRunTrigger
started_at	time.Time
duration_ms	int64	optional (omitempty)
cost_usd	float64	optional (omitempty)
identity	types.IdentityScope — see IdentityScope
error_class	string	optional (omitempty)

FlowRunDescribeRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
run_id	string

FlowRunDescription

Declared in internal/protocol/types.

Wire key	Go type	Notes
run	types.FlowRun — see FlowRun
node_states	[]types.FlowNodeRunState — see FlowNodeRunState
output_preview	string	optional (omitempty)
output_ref	*types.FlowArtifactRef — see FlowArtifactRef	optional (omitempty)

FlowRunRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
flow_id	string
inputs	map[string]any	optional (omitempty)

FlowRunResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
run_id	string
status	types.FlowRunStatus
started_at	time.Time

FlowRunsListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
flow_id	string
tenants	[]string	optional (omitempty)
page	int	optional (omitempty)
page_size	int	optional (omitempty)

FlowRunsListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
runs	[]types.FlowRun — see FlowRun
page	int
page_size	int
page_count	int
total_rows	int

GovernancePostureRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenant_id	string	optional (omitempty)

GovernancePostureResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
default_tier	string
resolved_tier	string
identity_tiers	map[string]types.IdentityTierView — see IdentityTierView
protocol_version	string

HistogramBucket

Declared in internal/protocol/types.

Wire key	Go type	Notes
upper_bound	float64
count	uint64

IdentityScope

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenant	string
user	string
session	string
run	string	optional (omitempty)
scope	string	optional (omitempty)
actor	*types.IdentityScope — see IdentityScope	optional (omitempty)
requester	*types.IdentityScope — see IdentityScope	optional (omitempty)
impersonating	*types.IdentityScope — see IdentityScope	optional (omitempty)

IdentityTierView

Declared in internal/protocol/types.

Wire key	Go type	Notes
budget_ceiling_usd	float64
rate_limit	types.RateLimitView — see RateLimitView
max_tokens	int

InterventionSummary

Declared in internal/protocol/types.

Wire key	Go type	Notes
type	string
reason	string
outcome	string
occurred_at	time.Time

LLMPostureRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenant_id	string	optional (omitempty)

LLMPostureResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
provider	string
model	string
region	string
mock_mode	bool
protocol_version	string

MCPAppCallToolRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
tool	string
arguments	json.RawMessage	optional (omitempty)

MCPAppCallToolResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
tool	string
content	json.RawMessage	optional (omitempty)
artifact_ref	*types.MCPResourceArtifactRef — see MCPResourceArtifactRef	optional (omitempty)
is_error	bool
app	*types.MCPAppRef — see MCPAppRef	optional (omitempty)
protocol_version	string

MCPAppRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
server_id	string	optional (omitempty)
tool_call_id	string	optional (omitempty)
resource_uri	string
display_mode	string	optional (omitempty)
raw_html_trusted	bool

MCPBindingScopeCount

Declared in internal/protocol/types.

Wire key	Go type	Notes
binding_scope	string
count	int32

MCPBindingView

Declared in internal/protocol/types.

Wire key	Go type	Notes
principal_id	string
binding_scope	string
scopes	[]string
expires_at	time.Time
last_used_at	time.Time

MCPHealthBucket

Declared in internal/protocol/types.

Wire key	Go type	Notes
start_ms	int64
latency_ms	int64

MCPPromptArg

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
description	string	optional (omitempty)
required	bool

MCPPromptView

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
description	string	optional (omitempty)
arguments	[]types.MCPPromptArg — see MCPPromptArg

MCPReconnect

Declared in internal/protocol/types.

Wire key	Go type	Notes
occurred_at	time.Time
reason	string	optional (omitempty)

MCPResourceArtifactRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
mime_type	string	optional (omitempty)
size_bytes	int64	optional (omitempty)
filename	string	optional (omitempty)
sha256	string	optional (omitempty)

MCPResourceView

Declared in internal/protocol/types.

Wire key	Go type	Notes
uri	string
mime_type	string	optional (omitempty)
size_bytes	int64	optional (omitempty)
name	string	optional (omitempty)
title	string	optional (omitempty)

MCPServerBindingsListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerBindingsListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
bindings	[]types.MCPBindingView — see MCPBindingView
protocol_version	string

MCPServerGetRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerGetResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
server	types.MCPServerView — see MCPServerView
display_modes_advertised	[]string
content_shapes	[]string
tool_policy	types.MCPToolPolicyView — see MCPToolPolicyView
bindings_summary	[]types.MCPBindingScopeCount — see MCPBindingScopeCount
protocol_version	string

MCPServerHealthRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerHealthResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
handshake_latency_buckets	[]types.MCPHealthBucket — see MCPHealthBucket
reconnect_history	[]types.MCPReconnect — see MCPReconnect
transport_error_rate	float64
protocol_version	string

MCPServerPolicyRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerPolicyResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
tool_policy	types.MCPToolPolicyView — see MCPToolPolicyView
protocol_version	string

MCPServerProbeRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerProbeResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
ok	bool
latency_ms	int64
error	string	optional (omitempty)
protocol_version	string

MCPServerPromptsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerPromptsResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
prompts	[]types.MCPPromptView — see MCPPromptView
protocol_version	string

MCPServerRefreshBindingRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string
principal_id	string	optional (omitempty)

MCPServerRefreshBindingResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
authorize_url	string
state	string
protocol_version	string

MCPServerRefreshDiscoveryRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerRefreshDiscoveryResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
discovery_id	string
tool_count	int32
resource_count	int32
prompt_count	int32
protocol_version	string

MCPServerResourcesRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string

MCPServerResourcesResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
resources	[]types.MCPResourceView — see MCPResourceView
protocol_version	string

MCPServerRevokeBindingRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string
principal_id	string	optional (omitempty)

MCPServerRevokeBindingResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
revoked	bool
protocol_version	string

MCPServerSetRawHTMLTrustRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
name	string
trusted	bool

MCPServerSetRawHTMLTrustResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
trusted	bool
protocol_version	string

MCPServerView

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
transport	string
url_or_command	string
state	types.MCPServerStateView
last_discovery_at	time.Time
tool_count	int32
resource_count	int32
prompt_count	int32
recent_latency_ms	int64
error_rate_per_min	float64
oauth_binding_count	int32
raw_html_trusted	bool

MCPServersListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
state	[]types.MCPServerStateView	optional (omitempty)
transport	[]string	optional (omitempty)
has_oauth	*bool	optional (omitempty)
has_recent_error	*bool	optional (omitempty)
name_prefix	string	optional (omitempty)
page_token	string	optional (omitempty)
page_size	int32	optional (omitempty)

MCPServersListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
servers	[]types.MCPServerView — see MCPServerView
next_page_token	string	optional (omitempty)
protocol_version	string

MCPToolPolicyView

Declared in internal/protocol/types.

Wire key	Go type	Notes
timeout_ms	int64
max_retries	int32
concurrency_cap	int32

MemoryAggregates

Declared in internal/protocol/types.

Wire key	Go type	Notes
total	int64
expiring_in_1h	int64
identity_rejected_24h	int64
recovery_dropped_24h	int64

MemoryArtifactRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
mime_type	string	optional (omitempty)
size_bytes	int64	optional (omitempty)
filename	string	optional (omitempty)
sha256	string	optional (omitempty)

MemoryDeleteRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
key	string

MemoryDeleteResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
deleted	bool
remaining_turns	int
protocol_version	string

MemoryFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenant_ids	[]string	optional (omitempty)
user_ids	[]string	optional (omitempty)
session_ids	[]string	optional (omitempty)
agent_ids	[]string	optional (omitempty)
scopes	[]string	optional (omitempty)
drivers	[]string	optional (omitempty)
strategies	[]string	optional (omitempty)
has_ttl_expiring	bool	optional (omitempty)
content_search	string	optional (omitempty)

MemoryGetRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
key	string

MemoryGetResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
detail	types.MemoryItemDetail — see MemoryItemDetail
protocol_version	string

MemoryHealthAggregate

Declared in internal/protocol/types.

Wire key	Go type	Notes
total	int64
expiring_in_1h	int64
identity_rejected_24h	int64
recovery_dropped_24h	int64
driver_by_scope	map[string]string

MemoryHealthRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope

MemoryHealthResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
aggregate	types.MemoryHealthAggregate — see MemoryHealthAggregate
protocol_version	string

MemoryItem

Declared in internal/protocol/types.

Wire key	Go type	Notes
key	string
strategy	string
scope	string
identity	types.IdentityScope — see IdentityScope
agent_id	string	optional (omitempty)
created_at	time.Time
last_updated_at	time.Time
expires_at	time.Time	optional (omitempty)
size_bytes	int64
heavy_content	bool	optional (omitempty)
driver	string

MemoryItemDetail

Declared in internal/protocol/types.

Wire key	Go type	Notes
item	types.MemoryItem — see MemoryItem
value	[]uint8	optional (omitempty)
value_artifact	*types.MemoryArtifactRef — see MemoryArtifactRef	optional (omitempty)
metadata	types.MemoryMetadata — see MemoryMetadata

MemoryListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.MemoryFilter — see MemoryFilter	optional (omitempty)
page	int	optional (omitempty)
page_size	int	optional (omitempty)

MemoryListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
items	[]types.MemoryItem — see MemoryItem
page	int
page_size	int
page_count	int
total_rows	int
aggregates	types.MemoryAggregates — see MemoryAggregates
protocol_version	string

MemoryMetadata

Declared in internal/protocol/types.

Wire key	Go type	Notes
ttl	time.Duration	optional (omitempty)
strategy_config	map[string]string	optional (omitempty)
related_event_ids	[]string	optional (omitempty)

MemoryPutRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
turn	types.MemoryTurnInput — see MemoryTurnInput

MemoryPutResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
key	string
protocol_version	string

MemoryStrategyTrace

Declared in internal/protocol/types.

Wire key	Go type	Notes
strategy	string
summary	string
recent_turn_count	int
estimated_tokens	int
health	string

MemoryStrategyTraceRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope

MemoryStrategyTraceResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
trace	types.MemoryStrategyTrace — see MemoryStrategyTrace
protocol_version	string

MemoryTurnInput

Declared in internal/protocol/types.

Wire key	Go type	Notes
user_text	string
assistant_text	string

MetricsSnapshot

Declared in internal/protocol/types.

Wire key	Go type	Notes
counters	[]types.NamedCounter — see NamedCounter
histograms	[]types.NamedHistogram — see NamedHistogram
gauges	[]types.NamedGauge — see NamedGauge
snapshot_at	int64

NamedCounter

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
value	float64
labels	map[string]string	optional (omitempty)

NamedGauge

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
value	float64
labels	map[string]string	optional (omitempty)

NamedHistogram

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
count	uint64
sum	float64
buckets	[]types.HistogramBucket — see HistogramBucket	optional (omitempty)
labels	map[string]string	optional (omitempty)

PauseArtifactRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
mime_type	string	optional (omitempty)
size_bytes	int64	optional (omitempty)
filename	string	optional (omitempty)
sha256	string	optional (omitempty)

PauseFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
status	[]string	optional (omitempty)
tenant_ids	[]string	optional (omitempty)
user_ids	[]string	optional (omitempty)
session_ids	[]string	optional (omitempty)
run_ids	[]string	optional (omitempty)
reasons	[]string	optional (omitempty)
since	time.Time	optional (omitempty)
until	time.Time	optional (omitempty)

PauseListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.PauseFilter — see PauseFilter	optional (omitempty)
page	int	optional (omitempty)
page_size	int	optional (omitempty)

PauseListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
snapshots	[]types.PauseSnapshot — see PauseSnapshot
page	int
page_size	int
page_count	int
total_rows	int
truncated	bool	optional (omitempty)

PauseSnapshot

Declared in internal/protocol/types.

Wire key	Go type	Notes
token	string
reason	string
state	types.PauseSnapshotState
identity	types.IdentityScope — see IdentityScope
paused_at	time.Time
resumed_at	time.Time	optional (omitempty)
payload	map[string]any	optional (omitempty)
payload_ref	*types.PauseArtifactRef — see PauseArtifactRef	optional (omitempty)

RateLimitView

Declared in internal/protocol/types.

Wire key	Go type	Notes
capacity	int
refill_tokens	int
refill_interval_ms	int64

ReadMCPResourceRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
server_id	string
resource_uri	string

ReadMCPResourceResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
resource_uri	string
mime_type	string	optional (omitempty)
content	string	optional (omitempty)
artifact_ref	*types.MCPResourceArtifactRef — see MCPResourceArtifactRef	optional (omitempty)
protocol_version	string

RunOverrides

Declared in internal/protocol/types.

Wire key	Go type	Notes
session_id	string
reasoning_effort	*string	optional (omitempty)
temperature	*float64	optional (omitempty)
max_tokens	*int	optional (omitempty)
system_prompt_override	*string	optional (omitempty)

RunSetOverridesRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
overrides	types.RunOverrides — see RunOverrides

RunSetOverridesResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
applied_at	time.Time
protocol_version	string

RuntimeCounters

Declared in internal/protocol/types.

Wire key	Go type	Notes
events_per_second	float64
tasks_running	int64
background_jobs_active	int64
mcp_connections_healthy	int64
sessions_active	int64
snapshot_at	int64

RuntimeDrivers

Declared in internal/protocol/types.

Wire key	Go type	Notes
subsystems	[]types.SubsystemDriver — see SubsystemDriver

RuntimeHealth

Declared in internal/protocol/types.

Wire key	Go type	Notes
subsystems	[]types.SubsystemHealth — see SubsystemHealth

RuntimeInfo

Declared in internal/protocol/types.

Wire key	Go type	Notes
instance_id	string
display_name	string	optional (omitempty)
build_version	string
build_commit	string
build_date	string	optional (omitempty)
build_go_version	string
protocol_version	string
capabilities	[]types.Capability
uptime_seconds	int64
mcp_app_display_modes	[]string	optional (omitempty)

RuntimeInfoRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope

SearchArtifactRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
mime_type	string	optional (omitempty)
size_bytes	int64	optional (omitempty)
filename	string	optional (omitempty)
sha256	string	optional (omitempty)

SearchFacet

Declared in internal/protocol/types.

Wire key	Go type	Notes
key	string
value	string

SearchFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
tenant_ids	[]string	optional (omitempty)
user_ids	[]string	optional (omitempty)
session_ids	[]string	optional (omitempty)
since	time.Time	optional (omitempty)
until	time.Time	optional (omitempty)

SearchRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
query	string	optional (omitempty)
indexes	[]types.SearchIndex	optional (omitempty)
filter	types.SearchFilter — see SearchFilter	optional (omitempty)
facets	[]types.SearchFacet — see SearchFacet	optional (omitempty)
page	int	optional (omitempty)
page_size	int	optional (omitempty)

SearchResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
rows	[]types.SearchResultRow — see SearchResultRow
page	int
page_size	int
page_count	int
total_count	int64
has_more	bool
protocol_version	string

SearchResultRow

Declared in internal/protocol/types.

Wire key	Go type	Notes
index	types.SearchIndex
id	string
tenant_id	string
user_id	string
session_id	string
run_id	string	optional (omitempty)
occurred_at	time.Time	optional (omitempty)
preview	string	optional (omitempty)
ref	*types.SearchArtifactRef — see SearchArtifactRef	optional (omitempty)
facets	map[string]string	optional (omitempty)

SessionFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
statuses	[]types.SessionStatus	optional (omitempty)
agent_ids	[]string	optional (omitempty)
user_ids	[]string	optional (omitempty)
tenant_ids	[]string	optional (omitempty)
started_window	types.Window — see Window	optional (omitempty)
has_intervention	*bool	optional (omitempty)
has_failed_task	*bool	optional (omitempty)
cost_above_cents	*int64	optional (omitempty)
query	string	optional (omitempty)

SessionRow

Declared in internal/protocol/types.

Wire key	Go type	Notes
session_id	string
status	types.SessionStatus
agent_id	string
agent_name	string
user_id	string
tenant_id	string
started_at	time.Time
last_activity_at	time.Time
duration	time.Duration
tasks_count	int
events_count	int
total_cost_cents	int64
total_tokens	int64
has_pending_intervention	bool
has_failed_task	bool
identity	types.IdentityScope — see IdentityScope

SessionsInspectRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
session_id	string

SessionsInspectResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
row	types.SessionRow — see SessionRow
recent_interventions	[]types.InterventionSummary — see InterventionSummary
recent_artifacts	[]types.ArtifactRefSummary — see ArtifactRefSummary

SessionsListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.SessionFilter — see SessionFilter
sort	types.SessionSort	optional (omitempty)
cursor	string	optional (omitempty)
limit	int	optional (omitempty)

SessionsListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
rows	[]types.SessionRow — see SessionRow
next_cursor	string
truncated	bool

SizeRange

Declared in internal/protocol/types.

Wire key	Go type	Notes
min_bytes	*int64	optional (omitempty)
max_bytes	*int64	optional (omitempty)

StartRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
query	string	optional (omitempty)
description	string	optional (omitempty)
priority	int	optional (omitempty)
idempotency_key	string	optional (omitempty)
input_artifact_ids	[]string	optional (omitempty)
input_artifact_dispositions	map[string]string	optional (omitempty)

StartResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
task_id	string
reused	bool
protocol_version	string

SubsystemDriver

Declared in internal/protocol/types.

Wire key	Go type	Notes
subsystem	string
driver	string
mode	string	optional (omitempty)

SubsystemHealth

Declared in internal/protocol/types.

Wire key	Go type	Notes
subsystem	string
status	string
detail	string	optional (omitempty)

TaskCostRollup

Declared in internal/protocol/types.

Wire key	Go type	Notes
total_tokens	int64
prompt_tokens	int64
output_tokens	int64
usd	float64
per_step	[]types.TaskCostStep — see TaskCostStep

TaskCostStep

Declared in internal/protocol/types.

Wire key	Go type	Notes
step_index	int
tokens	int64
usd	float64

TaskDetail

Declared in internal/protocol/types.

Wire key	Go type	Notes
task	types.TaskRow — see TaskRow
parent_session	types.TaskParentSessionRef — see TaskParentSessionRef
parent_task	*types.TaskParentTaskRef — see TaskParentTaskRef	optional (omitempty)
cost	types.TaskCostRollup — see TaskCostRollup
planner_snapshot	*types.TaskPlannerSnapshotRef — see TaskPlannerSnapshotRef	optional (omitempty)
result_ref	*types.ArtifactRef — see ArtifactRef	optional (omitempty)
result_inline	string	optional (omitempty)
trajectory	*types.TaskTrajectoryRef — see TaskTrajectoryRef	optional (omitempty)
input_artifacts	[]types.TaskInputArtifact — see TaskInputArtifact	optional (omitempty)

TaskFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
statuses	[]types.TaskStatus	optional (omitempty)
kinds	[]types.TaskKind	optional (omitempty)
parent_task_id	string	optional (omitempty)
identities	[]types.IdentityScope — see IdentityScope	optional (omitempty)
since	time.Time	optional (omitempty)
until	time.Time	optional (omitempty)
error_classes	[]string	optional (omitempty)
latency_above_ms	int64	optional (omitempty)
search	string	optional (omitempty)
group_id	string	optional (omitempty)
has_pending_approval	*bool	optional (omitempty)

TaskGetRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

TaskInputArtifact

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
disposition	string	optional (omitempty)

TaskListAggregates

Declared in internal/protocol/types.

Wire key	Go type	Notes
pending	int64
running	int64
paused	int64
failed	int64
complete	int64
cancelled	int64

TaskListCursor

Declared in internal/protocol/types.

Wire key	Go type	Notes
next_page_token	string	optional (omitempty)

TaskListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.TaskFilter — see TaskFilter
page_size	int	optional (omitempty)
cursor	types.TaskListCursor — see TaskListCursor
include_status_counter_strip	bool	optional (omitempty)

TaskListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
rows	[]types.TaskRow — see TaskRow
cursor	types.TaskListCursor — see TaskListCursor
aggregates	types.TaskListAggregates — see TaskListAggregates
status_counter_strip	*types.TasksListStatusCounterStrip — see TasksListStatusCounterStrip	optional (omitempty)

TaskParentSessionRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
session_id	string
agent_name	string
status	string
started_at	time.Time
latest_event_at	time.Time

TaskParentTaskRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
task_id	string
kind	types.TaskKind
status	types.TaskStatus

TaskPlannerSnapshotRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
checkpoint_id	string
summary	string

TaskRow

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
kind	types.TaskKind
status	types.TaskStatus
priority	int
identity	types.IdentityScope — see IdentityScope
parent_session_id	string
parent_task_id	string	optional (omitempty)
description	string
query	string
started_at	time.Time
updated_at	time.Time
duration_ms	int64
error_class	string	optional (omitempty)
tool_count	int
background_acknowledged	bool
group_id	string	optional (omitempty)
progress	*float64	optional (omitempty)
tags	[]string	optional (omitempty)
last_activity_at	time.Time
is_background	bool
has_pending_approval	bool

TaskTrajectoryRef

Declared in internal/protocol/types.

Wire key	Go type	Notes
steps	[]types.TaskTrajectoryStep — see TaskTrajectoryStep

TaskTrajectoryStep

Declared in internal/protocol/types.

Wire key	Go type	Notes
index	int
reasoning_trace	string

TasksListStatusCounterStrip

Declared in internal/protocol/types.

Wire key	Go type	Notes
pending	int
running	int
completed	int
paused	int
failed	int

TimeRange

Declared in internal/protocol/types.

Wire key	Go type	Notes
after	time.Time	optional (omitempty)
before	time.Time	optional (omitempty)

Tool

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
name	string
version	string
description	string
scope	string
transport	types.ToolTransport
oauth_status	types.ToolOAuthStatus
approval_policy	types.ToolApprovalPolicy
reliability_tier	string
owner	string
last_used_at	time.Time

ToolAggregates

Declared in internal/protocol/types.

Wire key	Go type	Notes
total	int64
active	int64
pending_approval	int64
awaiting_oauth	int64

ToolContentBucket

Declared in internal/protocol/types.

Wire key	Go type	Notes
max_bytes	int64
count	int64

ToolContentStats

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
histogram	[]types.ToolContentBucket — see ToolContentBucket
heavy_threshold_bytes	int64
heavy_count	int64
negotiated_display	map[string]string

ToolContentStatsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

ToolContextPayload

Declared in internal/protocol/types.

Wire key	Go type	Notes
content	json.RawMessage	optional (omitempty)
artifact_ref	*types.MCPResourceArtifactRef — see MCPResourceArtifactRef	optional (omitempty)

ToolContextRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
server_id	string
tool_call_id	string

ToolContextResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
tool	string
input	types.ToolContextPayload — see ToolContextPayload
result	types.ToolContextPayload — see ToolContextPayload
is_error	bool
protocol_version	string

ToolDescribeRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

ToolFilter

Declared in internal/protocol/types.

Wire key	Go type	Notes
scopes	[]string	optional (omitempty)
transports	[]types.ToolTransport	optional (omitempty)
oauth_statuses	[]types.ToolOAuthStatus	optional (omitempty)
approval_policies	[]types.ToolApprovalPolicy	optional (omitempty)
reliability_tiers	[]string	optional (omitempty)
search	string	optional (omitempty)

ToolGetRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

ToolListRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
filter	types.ToolFilter — see ToolFilter
page	int	optional (omitempty)
page_size	int	optional (omitempty)

ToolListResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
tools	[]types.Tool — see Tool
page	int
page_size	int
page_count	int
total_rows	int64
aggregates	types.ToolAggregates — see ToolAggregates

ToolManifest

Declared in internal/protocol/types.

Wire key	Go type	Notes
tool	types.Tool — see Tool
side_effect	string
args_schema	string
out_schema	string
examples	[]string
auth_scopes	[]string
oauth_binding_scope	string
retry_attempts	int
timeout_ms	int64
loading_mode	string
display_modes	map[string]string

ToolMetrics

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
window	types.ToolMetricsWindow
error_rate_1h	float64
error_rate_24h	float64
error_rate_7d	float64
invocations	int64
failures	int64
status	types.ToolStatus

ToolMetricsRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string
window	types.ToolMetricsWindow	optional (omitempty)

ToolRevokeOAuthRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string

ToolRevokeOAuthResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
revoked_count	int64

ToolSetApprovalPolicyRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope
id	string
policy	types.ToolApprovalPolicy

ToolSetApprovalPolicyResponse

Declared in internal/protocol/types.

Wire key	Go type	Notes
id	string
policy	types.ToolApprovalPolicy

TopologyEdge

Declared in internal/protocol/types.

Wire key	Go type	Notes
from	string
to	string
queue_depth	int
queue_capacity	int

TopologyNode

Declared in internal/protocol/types.

Wire key	Go type	Notes
name	string
kind	types.TopologyNodeKind

TopologyProjection

Declared in internal/protocol/types.

Wire key	Go type	Notes
engine_id	string
occurred_at	time.Time
nodes	[]types.TopologyNode — see TopologyNode
edges	[]types.TopologyEdge — see TopologyEdge

TopologySnapshotRequest

Declared in internal/protocol/types.

Wire key	Go type	Notes
identity	types.IdentityScope — see IdentityScope

Version

Declared in internal/protocol/types.

Wire key	Go type	Notes
Major	int
Minor	int
Patch	int

VersionHandshake

Declared in internal/protocol/types.

Wire key	Go type	Notes
protocol_version	string
capabilities	[]types.Capability

Window

Declared in internal/protocol/types.

Wire key	Go type	Notes
from	*time.Time	optional (omitempty)
to	*time.Time	optional (omitempty)